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.


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> Bucket name String
<namespace> Namespace name String
<owner> Owner name String
<default_group> Default group String
<user_acl>     0-* Elements
<user> User name String
<permission> Permission list String 0-* Elements
<group_acl>     0-* Elements
<group> Group name String
<permission> List of group permissions String 0-* Elements
<customgroup_acl>     0-* Elements
<customgroup> Custom group name String
<permission> List of custom group permissions String 0-* Elements
<default_group_file_perms> The default group's file permissions String 0-* Elements
<default_group_dir_perms> The default group's directory permissions String 0-* Elements
<permission> Get short permission list for non namespace owner String 0-* Elements

Response Body

Response indicating Success or Failure of the operation



Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
HTTP/1.1 200 OK
Content-Type: application/xml