PowerScale OneFS API Reference

Request syntax

GET /namespace/<access_point>?acl&nsaccess=true HTTP/1.1
Host  <hostname>[:<port>]
Content-Length: <length>
Date: <date>
Authorization: <signature>

PUT /namespace/<access_point>?acl&nsaccess=true HTTP/1.1
Host <hostname>[:<port>]
Content-Length: <length>
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 access control list for the namespace access point is returned for the GET operation.

No message body is returned upon success for the PUT operation.

Example request 1

In this example, the GET operation retrieves the access control list from the namespace.

GET /namespace/ifs-ap1?acl&nsaccess=true HTTP/1.1
Host: my_cluster:8080
Authorization: <key>

Example response 1

HTTP/1.1 200 OK
Date: Mon, 25 Mar 2013 18:42:16 GMT
x-isi-ifs-spec-version: 1.0
Transfer-Encoding: chunked
Content-Type: application/json
 
{
   "acl":[
      {
         "accessrights":[
            "file_read"
         ],
         "accesstype":"allow",
         "inherit_flags":[

         ],
         "trustee":{
            "id":"UID:2000",
            "name":"user1",
            "type":"user"
         }
      }
   ],
   "authoritative":"acl",
   "group":{
      "id":"GID:0",
      "name":"wheel",
      "type":"group"
   },
   "mode":"0060",
   "owner":{
      "id":"UID:0",
      "name":"root",
      "type":"user"
   }
}

Example request 2

In this example, the request sets an access control list for the access point.

PUT /namespace/ifs-ap1?acl&nsaccess=true HTTP/1.1
Authorization: Basic QWxhZGRpbjpvcGVuIHN1c2FtZQ==
Host: 10.245.107.17:8080
Content-Type:application/json
Content-Length: 140

{
   "authoritative":"acl",
   "acl":[
      {
         "trustee":{
            "name":"user1",
            "type":"user"
         },
         "accesstype":"allow",
         "accessrights":[
            "file_read"
         ],
         "op":"add"
      }
    ]
}

Example response 2

HTTP/1.1 200 OK
Date: Mon, 25 Mar 2013 17:24:55 GMT
Transfer-Encoding: chunked
Content-Type: text/plain
x-isi-ifs-spec-version: 1.0