PowerScale OneFS API Reference

Request syntax

GET /namespace/<access_point>/<file_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/accesspoint1/directory1/file1?metadata HTTP/1.1
Host: 10.245.105.110:8080
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:19.0) Gecko/20100101 Firefox/19.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: en-US,en;q=0.5
Accept-Encoding: gzip, deflate
Cookie: _SID_=20130321154838-cffed57ca0a91f15a7dca80fc88ed0a8; isisessid=7651c367-71d1-4ff1-9dd0-1eee09a4b03d; legacy=1; ys-lastStatusDashView=n%3A1; ys-monitoringView=s%3ALIVE; ys-monitoringData=s%3AAVG
Connection: keep-alive
Cache-Control: max-age=0

Example response

HTTP/1.1 200 Ok
Date: Thu, 21 Mar 2013 19:58:11 GMT
Server: Apache/2.2.21 (FreeBSD) mod_ssl/2.2.21 OpenSSL/0.9.8x mod_webkit2/1.0 mod_fastcgi/2.4.6
Allow: DELETE, GET, HEAD, POST, PUT
x-isi-ifs-spec-version: 1.0
Keep-Alive: timeout=15, max=436
Connection: Keep-Alive
Transfer-Encoding: chunked
Content-Type: application/json

{
    "attrs": [
        {
            "name": "content_type",
            "value": "text/xml; charset=UTF-8"
        },
        {
            "name": "is_hidden",
            "value": false
        },
        {
            "name": "size",
            "value": 27
        },
        {
            "name": "block_size",
            "value": 8192
        },
        {
            "name": "blocks",
            "value": 52
        },
        {
            "name": "last_modified",
            "value": "Wed, 20 Mar 2013 18:16:17 GMT"
        },
        {
            "name": "change_time",
            "value": "Wed, 20 Mar 2013 18:16:17 GMT"
        },
        {
            "name": "access_time",
            "value": "Wed, 20 Mar 2013 18:16:17 GMT"
        },
        {
            "name": "create_time",
            "value": "Wed, 20 Mar 2013 18:16:17 GMT"
        },
        {
            "name": "mtime_val",
            "value": 1363803377
        },
        {
            "name": "ctime_val",
            "value": 1363803377
        },
        {
            "name": "atime_val",
            "value": 1363803377
        },
        {
            "name": "btime_val",
            "value": 1363803377
        },
        {
            "name": "owner",
            "value": "root"
        },
        {
            "name": "group",
            "value": "wheel"
        },
        {
            "name": "uid",
            "value": 0
        },
        {
            "name": "gid",
            "value": 0
        },
        {
            "name": "id",
            "value": 4300276817
        },
        {
            "name": "nlink",
            "value": 1
        },
        {
            "name": "type",
            "value": "object"
        },
        {
            "name": "mode",
            "value": "0600"
        },
        {
            "name": "Manufacture",
            "namespace": "user",
            "value": "Foo"
        },
        {
            "name": "user.Material",
            "namespace": "user",
            "value": "Steel"
        }
    ]
}