Spectra Logic

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

Create Bucket ACL for a User

Description

Create an ACL for a bucket, granting the specified permission to the specified user.

Notes:

§	Only administrators and users with OWNER access to the bucket are allowed to create an ACL for it.

§	A single operation can only grant one permission. To grant multiple permissions, submit the request multiple times with different permissions specified.

Requests

Syntax

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

Request Parameters 

Parameter	Description	Required
bucket_id	The UUID, name, or other unique attribute for the bucket.	yes
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	The UUID for the bucket.
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 bc2b161c-e7fb-4f08-bddd-65bb3cb56ebc to be able to list objects in the bucket with the name “bucket2”.

POST http[s]://blackpearl-hostname/_rest_/bucket_acl​?bucket_id=bucket2&user_id=bc2b161c-e7fb-4f08-bddd-65bb3cb56ebc​&permission=list HTTP/1.1

Sample Response

HTTP/1.1 201 CREATED
<Data>
   <BucketId>c76ab540-9ef6-4665-bd81-af0cce744ef6</BucketId>
   <GroupId/>
   <Id>d476fe78-d76b-40d6-ad64-1d2c130425d3</Id>

   <Permission>LIST</Permission>

   <UserId>bc2b161c-e7fb-4f08-bddd-65bb3cb56ebc</UserId>
</Data>