Bucket:Get Bucket ACL

Search (SHIFT+S)

New in this release

Get Bucket ACL

GET /object/bucket/{bucketName}/acl

Gets the ACL for the given bucket. Current user's namespace is used.

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

Query Parameters

namespaceNamespace with which bucket is associated. If it is null, the current user's namespace is used.

Required Roles

Requires one of the following roles:




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

  • Bucket must exist.

Response Body

Response contains the ACL details for the specified bucket.

Field Description Type Notes
<bucket> Bucket name String
<namespace> Namespace name String
<owner> Owner name 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
<permission> Get short permission list for non namespace owner String 0-* Elements


GET HTTP/1.1  

Concept-Type: application/xml 
HTTP/1.1 200 OK
Content-Type: application/xml 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>