Description

This API is used to get the ACL of a specified bucket. Calling this API requires READ_ACP permission.

Request syntax

Request parameters and headers

For common request headers, see Common parameters.

Name	Location	Type	Required	Sample Value	Description
acl	Query	String	Yes	-	Identifies a GetBucketACL request.

Request body elements

No elements are used.

Response headers

For common response headers, see Common parameters.

Response body elements

Name	Type	Description
Grants	Array	The root node for object access control.
Grantee	Object	The authorized user. Parent node: Grants.
Type	String	The user type. Parent node: Grantee.
Canned	String	This property is returned when Type is Group. Valid values: AllUsers: All users. AuthenticatedUsers: Users that have been authorized based on the account ID. Parent node: Grantee.
ID	String	This property is returned when Type is CanonicalUser, indicating the authorized user ID. Parent node: Grantee.
Permission	String	The permission type. The value descriptions are as follows: READ：Allow the authorized user to access bucket metadata, object metadata, download objects, list objects within a bucket, and view shard tasks. READ_NON_LIST：Allow authorized users to access bucket metadata, object metadata, and download objects. WRITE：Allow authorized users to create, overwrite, and delete any object in the bucket, initialize multipart tasks, upload parts, merge parts, and cancel multipart tasks. READ_ACP：Allow the authorized party to read the ACL of the bucket. WRITE_ACP：Allow the authorized user to modify or delete the ACL of the bucket. FULL_CONTROL：Allow the grantee to have READ, WRITE, READ_ACP, and WRITE_ACP permissions on the bucket. Parent node: Grantee.
Owner	Object	The object owner.
ID	String	The account ID. Parent node: Owner.
BucketAclDelivered	Bool	Whether to enable default object inheritance bucket ACL function, the possible values are as follows: true：Enable object default inheritance of bucket ACL functionality. false：Disable object default inheritance of bucket ACL functionality.

Sample request

Sample response

Torch Object Storage