paws.storage (version 0.1.11)

s3_get_bucket_acl: This implementation of the GET operation uses the acl subresource to return the access control list (ACL) of a bucket

Description

This implementation of the GET operation uses the acl subresource to return the access control list (ACL) of a bucket. To use GET to return the ACL of the bucket, you must have READ_ACP access to the bucket. If READ_ACP permission is granted to the anonymous user, you can return the ACL of the bucket without using an authorization header.

Related Resources

• list_objects

Usage

s3_get_bucket_acl(Bucket, ExpectedBucketOwner)

Arguments

Bucket

[required] Specifies the S3 bucket whose ACL is being requested.

ExpectedBucketOwner

The account id of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied) error.

Value

A list with the following syntax:

list(
  Owner = list(
    DisplayName = "string",
    ID = "string"
  ),
  Grants = list(
    list(
      Grantee = list(
        DisplayName = "string",
        EmailAddress = "string",
        ID = "string",
        Type = "CanonicalUser"|"AmazonCustomerByEmail"|"Group",
        URI = "string"
      ),
      Permission = "FULL_CONTROL"|"WRITE"|"WRITE_ACP"|"READ"|"READ_ACP"
    )
  )
)

Request syntax

svc$get_bucket_acl(
  Bucket = "string",
  ExpectedBucketOwner = "string"
)