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:

  • SYSTEM_ADMIN

  • SYSTEM_MONITOR


Prerequisites

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_acl>
<bucket> Bucket name String
<namespace> Namespace name String
<acl>    
<owner> Owner name String
<default_group> Default group 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>      
<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
</acl>      
<permission> Get short permission list for non namespace owner String 0-* Elements
</bucket_acl>

Examples

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

Concept-Type: application/xml 
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>
Response
HTTP/1.1 200 OK
Content-Type: application/xml 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bucket_acl>
    <bucket>standalone-bucket</bucket>
    <namespace>s3</namespace>
    <acl>
        <user_acl>
            <user>wuser1@sanity.local</user>
            <permission>full_control</permission>
        </user_acl>
    </acl>
</bucket_acl>
Notes: