PowerScale OneFS API Reference

Request syntax

GET /namespace/<access_point>/<container_path>?metadata HTTP/1.1
Host <hostname>[:<port>]
Date: <date>
Authorization: <signature>

Request query parameters

Request headers

This call sends common request headers.

Response headers

This call returns common response headers.

Response body

The object attribute information is returned in JSON format.

{
   "attrs":[
      {
         "name":"<key_name>",
         "value":"<key_value>",
         "namespace":"<namespace_value>"
      },
      ...
   ]
}

Example request

GET /namespace/ifs/my_folder/?metadata HTTP/1.1
Host my_cluster:8080
Content-Length : <length>
Date: Thu, 22 Sep 2011 12:00:00 GMT
Authorization: <signature>

Example response

HTTP/1.1 200 OK
Date: Thu, 22 Sep 2011 12:00:00 GMT
Content-Length: <Length>
Content-Type: application/JSON
Connection: close
Server: Apache2/2.2.19

{
   "attrs":[
      {
         "name":"is_hidden",
         "value":false
      },
      {
         "name":"size",
         "value":96
      },
      {
         "name":"block_size",
         "value":8192
      },
      {
         "name":"blocks",
         "value":4
      },
      {
         "name":"last_modified",
         "value":"Fri, 23 Mar 2012 16:32:42 GMT"
      },
      {
         "name":"change_time",
         "value":"Fri, 23 Mar 2012 16:32:42 GMT"
      },
      {
         "name":"access_time",
         "value":"Fri, 23 Mar 2012 16:32:42 GMT"
      },
      {
         "name":"create_time",
         "value":"Wed, 21 Mar 2012 22:06:23 GMT"
      },
      {
         "name":"mtime_val",
         "value":1332520362
      },
      {
         "name":"ctime_val",
         "value":1332520362
      },
      {
         "name":"atime_val",
         "value":1332520362
      },
      {
         "name":"btime_val",
         "value":1332367583
      },
      {
         "name":"owner",
         "value":"root"
      },
      {
         "name":"group",
         "value":"wheel"
      },
      {
         "name":"uid",
         "value":0
      },
      {
         "name":"gid",
         "value":0
      },
      {
         "name":"id",
         "value":2
      },
      {
         "name":"nlink",
         "value":6
      },
      {
         "name":"type",
         "value":"container"
      },
      {
         "name":"mode",
         "value":511
      }
   ]
}