All Products
Search
Document Center

Object Storage Service:get-bucket-acl

Last Updated:Mar 20, 2026

Queries the access control list (ACL) of a bucket.

Syntax

ossutil api get-bucket-acl --bucket value [flags]

Parameters

ParameterTypeDescription
--bucketstringThe name of the bucket whose ACL you want to query.
Note: For all available flags, see Command-line options.

Examples

Get the ACL of a bucket:

ossutil api get-bucket-acl --bucket examplebucket

Get the ACL and display the response in JSON format:

ossutil api get-bucket-acl --bucket examplebucket --output-format json

Sample response:

{
  "AccessControlList": {
    "Grant": "public-read-write"
  },
  "Owner": {
    "DisplayName": "137918634953****",
    "ID": "137918634953****"
  }
}

0.409493(s) elapsed

Get the ACL and display the response in YAML format:

ossutil api get-bucket-acl --bucket examplebucket --output-format yaml

Sample response:

AccessControlList:
    Grant: public-read-write
Owner:
    DisplayName: "137918634953****"
    ID: "137918634953****"

0.313081(s) elapsed

Output

The response contains the following fields:

FieldTypeDescription
AccessControlList.GrantstringThe ACL of the bucket.
Owner.DisplayNamestringThe display name of the bucket owner.
Owner.IDstringThe account ID of the bucket owner.