All Products
Search
Document Center

Object Storage Service:get-bucket-acl

Last Updated:Jul 31, 2024

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

Syntax

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

Parameter

Type

Description

--bucket

string

The name of the bucket whose ACL you want to query.

Note

For more information, see Command-line options.

Examples

  • Query the ACL of a bucket named examplebucket:

    ossutil api get-bucket-acl --bucket examplebucket
  • Query the ACL of a bucket named examplebucket and specify that the response is displayed in JSON format:

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

    Sample success response:

    {
      "AccessControlList": {
        "Grant": "public-read-write"
      },
      "Owner": {
        "DisplayName": "137918634953****",
        "ID": "137918634953****"
      }
    }
    
    0.409493(s) elapsed
  • Query the ACL of a bucket named examplebucket and specify that the response is displayed in YAML format:

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

    Sample success response:

    AccessControlList:
        Grant: public-read-write
    Owner:
        DisplayName: "137918634953****"
        ID: "137918634953****"
    
    0.313081(s) elapsed