Retrieve the Metadata for Items within a Folder

 

Updated: October 9, 2012

Applies To: Windows Server 2012 Essentials

Retrieves the metadata information of items under a folder. The metadata includes basic information such as the creation time, item type, modification time, name, path, and size.

GET services/builtin/FileOperationService.svc/items/index/{index}/count/{count}?path={path}

{index}
The numerical position of the first item to be retrieved.

{count}
The number of items to be retrieved.

{path}
A network path that begins with the server name, in the format /ServerName/FolderPath.

GET https://www.contoso.com/services/builtin/FileOperationService.svc/items/index/0/count/100?path=servername/Users HTTP/1.1  
Accept: application/xml  
Cookie: ASP.NET_SessionId=********************  
Canary: *********************  
Host: domainname  

HTTP/1.1 200 OK  

<ItemList  
    xmlns="http://contracts.microsoft.com/WindowsServerEssentials/2011/09/WebApi"  
    xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
  <Items>  
    <ItemInfo>  
      <AccessPermission>2</AccessPermission>  
      <CreateTime>2011-10-18T01:08:01.3153356-07:00</CreateTime>  
      <IsDirectory>true</IsDirectory>  
      <ModifiedTime>2011-10-18T01:08:01.3153356-07:00</ModifiedTime>  
      <Name>aa</Name>  
      <Path>\\SERVERNAME\Users</Path>  
      <Size>0</Size>  
    </ItemInfo>  
    <ItemInfo>  
      <AccessPermission>2</AccessPermission>  
      <CreateTime>2011-10-12T23:24:59.3006647-07:00</CreateTime>  
      <IsDirectory>true</IsDirectory>  
      <ModifiedTime>2011-10-18T19:49:06.1585762-07:00</ModifiedTime>  
      <Name>AuroraStdUser</Name>  
      <Path>\\SERVERNAME\Users</Path>  
      <Size>0</Size>  
    </ItemInfo>  
    <ItemInfo>  
      <AccessPermission>2</AccessPermission>  
      <CreateTime>2011-10-12T23:24:58.3945353-07:00</CreateTime>  
      <IsDirectory>true</IsDirectory>  
      <ModifiedTime>2011-10-16T20:03:33.9386717-07:00</ModifiedTime>  
      <Name>AuroraUser</Name>  
      <Path>\\SERVERNAME\Users</Path>  
      <Size>0</Size>  
    </ItemInfo>  
    <ItemInfo>  
      <AccessPermission>2</AccessPermission>  
      <CreateTime>2011-10-18T01:12:36.9315201-07:00</CreateTime>  
      <IsDirectory>true</IsDirectory>  
      <ModifiedTime>2011-10-18T01:12:36.9315201-07:00</ModifiedTime>  
      <Name>Sallyh</Name>  
      <Path>\\SERVERNAME\Users</Path>  
      <Size>0</Size>  
    </ItemInfo>  
  </Items>  
  <TotalCount>4</TotalCount>  
</ItemList>  

Error CodeError Message
400One or more parameters are not valid.
401Access is denied to the requested resource.
404The path does not exist.

The AccessPermission element in the response can contain one of the following enumeration values:

Enumeration Value NameValueMeaning
None0No access.
ReadOnly1Read-only access.
Full2Read/write access.
Other3Unknown or unspecified access.

Web Service Methods

Community Additions

ADD
Show: