Bucket:Get Bucket ACL

Search (SHIFT+S)

Get Bucket ACL

GET /object/bucket/{bucketName}/acl

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

bucketName	Name of the bucket for which ACL is to be updated.

Query Parameters

namespace	Namespace 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
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

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>

Request

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

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

Response

HTTP/1.1 200 OK 
Content-Type: application/json 

{
    "bucket": "standalone-bucket",
    "namespace": "s3",
    "acl": {
        "user_acl": [
            {
                "user": "wuser1@sanity.local",
                "permission": [
                    "full_control"
                ]
            }
        ],
        "group_acl": [],
        "customgroup_acl": []
    }
}

Request

curl -H $token -H "Content-Type: application/xml" -X GET https://$nodeIp:4443/object/bucket/standalone-bucket/acl

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>