Spectra Logic

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

Create Global Bucket ACL for a Group

Description

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

Note:

Only administrators are allowed to create a global bucket ACL.

Requests

Syntax

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

Request Parameters 

Parameter	Description	Required
group_id	The UUID, name, or other unique attribute for the group to which you want to grant the specified permission.	yes
permission	The type of permission to grant. See permission for a description. Values: LIST, READ, WRITE, DELETE, JOB, OWNER	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	The UUID for the group granted permission.
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	Always null for this operation.

Example

Sample Request

This request creates an ACL for the group with the UUID 1afdf1e6-2f60-4765-89b1-bf8c09d7b8a8 to be able to list objects in all buckets.

POST http[s]://blackpearl-hostname/_rest_/bucket_acl/?permission=list&group_id=1afdf1e6-2f60-4765-89b1-bf8c09d7b8a8 HTTP/1.1

Sample Response

HTTP/1.1 201 OK
<Data>
   <BucketId/>
   <GroupId>1afdf1e6-2f60-4765-89b1-bf8c09d7b8a8</GroupId>
   <Id>dca36600-5b3b-405e-a368-e631e78a338d</Id>

   <Permission>LIST</Permission>

   <UserId/>
</Data>