Spectra Logic

1-800-833-1132 : 1-303-449-6400

Create Global Bucket ACL for a User

Description

Create an ACL for all buckets, including those already created and those that will be created, granting the specified permission to the specified user.

Note:

Only administrators are allowed to create a global bucket ACL.

Requests

Syntax

POST http[s]://{datapathDNSname}/_rest_/bucket_acl/?permission=LIST|READ|WRITE|DELETE|JOB|OWNER&user_id={string}

Request Parameters 

Parameter	Description	Required
permission	The type of permission to grant. See permission for a description. Values: LIST, READ, WRITE, DELETE, JOB, OWNER	yes
user_id	The UUID, username, or other unique attribute for the user to whom you want to grant the specified permission.	yes

Responses

Response Elements

<Data>
   <BucketId>{string}</BucketId>
   <GroupId>{string}</GroupId>
   <Id>{string}</Id>

   <Permission>LIST|READ|WRITE|DELETE|JOB|OWNER</Permission>

   <UserId>{string}</UserId>
</Data>

where the response elements are defined as follows:

Parameter	Description
Data	The container for the response.
BucketId	Always null for this operation.
GroupId	Always null for this operation.
Id	The UUID for the ACL.
Permission	The permission granted by this ACL. See permission for a description. Values: LIST, READ, WRITE, DELETE, JOB, OWNER
UserId	The UUID for the user granted permission.

Example

Sample Request

This request creates an ACL for the user with the UUID ceb405c4-aa4e-4b1d-9e93-312c40901671 to be able to list objects in all buckets.

POST http[s]://blackpearl-hostname/_rest_/bucket_acl​?permission=list&user_id=ceb405c4-aa4e-4b1d-9e93-312c40901671 HTTP/1.1

Sample Response

HTTP/1.1 201 CREATED
<Data>
   <BucketId/>
   <GroupId/>
   <Id>72475859-6b28-46f8-b105-068cd87347b3</Id>

   <Permission>LIST</Permission>

   <UserId>ceb405c4-aa4e-4b1d-9e93-312c40901671</UserId>
</Data>