Export (0) Print
Expand All

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.

URI Template

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.

Sample Request

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

Sample Response

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 Codes

 

Error Code Error Message

400

One or more parameters are not valid.

401

Access is denied to the requested resource.

404

The path does not exist.

Remarks

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

 

Enumeration Value Name Value Meaning

None

0

No access.

ReadOnly

1

Read-only access.

Full

2

Read/write access.

Other

3

Unknown or unspecified access.

See Also

Show:
© 2015 Microsoft