PowerScale OneFS API Reference

Get or set an access control list for a namespace access point

Retrieves or sets the access control list for a namespace access point.

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


Parameter Name	Description	Default	Type	Required
acl	This parameter is a functional keyword that does not have a value.	N/A	N/A	Yes
nsaccess	Indicates that the operation is on the access point instead of the store path. This value must be set to true. If set to false or left blank, the request behaves similarly to a GET or PUT operation.	N/A	Boolean	Yes

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

Willkommen

Willkommen bei Dell