get-bucket-acl¶
Gets the access control policy for the bucket.
See also: AWS API Documentation.
Synopsis¶
get-bucket-acl
--bucket <value>
[--cli-input-json <value>]
Options¶
--bucket
(string)
--cli-input-json
(string)
Operates a service or services based on the provided JSON string. If other arguments are provided on the command line, the CLI values override the JSON-provided values. You cannot pass arbitrary binary values using a JSON-provided value, because the string is taken literally.
Examples¶
The following command retrieves the access control list for a bucket named “my-bucket”:
$ aws s3api get-bucket-acl --bucket my-bucket
Output
{
"Owner": {
"DisplayName": "my-username",
"ID": "7009a8971cd538e11f6b6606438875e7c86c5b672f46db45460ddcd087d36c32"
},
"Grants": [
{
"Grantee": {
"DisplayName": "my-username",
"ID": "7009a8971cd538e11f6b6606438875e7c86c5b672f46db45460ddcd087d36c32"
},
"Permission": "FULL_CONTROL"
}
]
}
Output¶
Owner -> (structure)
DisplayName -> (string)
ID -> (string)
Grants -> (list)
A list of grants.
(structure)
Grantee -> (structure)
DisplayName -> (string)
Screen name of the grantee.EmailAddress -> (string)
Email address of the grantee.ID -> (string)
The canonical user ID of the grantee.Type -> (string)
Type of granteeURI -> (string)
URI of the grantee group.Permission -> (string)
Specifies the permission given to the grantee.