Bucket:Set Bucket ACL

Search (SHIFT+S)




New in this release

Set Bucket ACL

PUT /object/bucket/{bucketName}/acl

Updates the ACL for the given bucket. If the buckets's namespace is not specified in the payload, the current user's namespace is used.

bucketNameName of the bucket for which the ACL is to be updated.

Required Roles

This call has no restrictions.


Prerequisites

The following conditions must be met in order to call this operation.

  • Bucket must exist.


Request Payload

All parameters are required unless otherwise stated.

Field Description Type Notes
<bucket_acl>
<bucket> Bucket name String
<namespace> Namespace name String
<acl>    
<owner> Owner name String
<user_acl>     0-* Elements
<user> User name String
<permission> Permission list String 0-* Elements
</user_acl>      
<group_acl>     0-* Elements
<group> Group name String
<permission> List of group permissions String 0-* Elements
</group_acl>      
<customgroup_acl>     0-* Elements
<customgroup> Custom group name String
<permission> List of custom group permissions String 0-* Elements
</customgroup_acl>      
</acl>      
<permission> Get short permission list for non namespace owner String 0-* Elements
</bucket_acl>

Response Body

Response indicating Success or Failure of the operation


Examples

Request
PUT https://192.168.0.0:4443/object/bucket/standalone-bucket/acl: HTTP/1.1

Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Owner>
    <ID>wuser1@sanity.local</ID>
    <DisplayName>4pVE+eihUpzoVHSgGFqvzCXNSydoRXOo9gdqwGMi</DisplayName>
  </Owner>
  <AccessControlList>
    <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
        <URI>http://acs.amazonaws.com/groups/global/AllUsers</URI>
      </Grantee>
      <Permission>WRITE</Permission>
    </Grant>
    <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
        <ID>geotest2@sanity.local</ID>
        <DisplayName>geotest2@sanity.local</DisplayName>
      </Grantee>
      <Permission>FULL_CONTROL</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>
Response
HTTP/1.1 200 OK
Content-Type: application/xml
Notes: