paws.storage (version 0.1.0)

s3_put_bucket_acl: Sets the permissions on a bucket using access control lists (ACL)

Description

Sets the permissions on a bucket using access control lists (ACL).

Usage

s3_put_bucket_acl(ACL, AccessControlPolicy, Bucket, ContentMD5,
  GrantFullControl, GrantRead, GrantReadACP, GrantWrite, GrantWriteACP)

Arguments

ACL

The canned ACL to apply to the bucket.

AccessControlPolicy

Bucket

[required]

ContentMD5

GrantFullControl

Allows grantee the read, write, read ACP, and write ACP permissions on the bucket.

GrantRead

Allows grantee to list the objects in the bucket.

GrantReadACP

Allows grantee to read the bucket ACL.

GrantWrite

Allows grantee to create, overwrite, and delete any object in the bucket.

GrantWriteACP

Allows grantee to write the ACL for the applicable bucket.

Request syntax

svc$put_bucket_acl(
  ACL = "private"|"public-read"|"public-read-write"|"authenticated-read",
  AccessControlPolicy = list(
    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"
      )
    ),
    Owner = list(
      DisplayName = "string",
      ID = "string"
    )
  ),
  Bucket = "string",
  ContentMD5 = "string",
  GrantFullControl = "string",
  GrantRead = "string",
  GrantReadACP = "string",
  GrantWrite = "string",
  GrantWriteACP = "string"
)

Examples

# NOT RUN {
# The following example replaces existing ACL on a bucket. The ACL grants
# the bucket owner (specified using the owner ID) and write permission to
# the LogDelivery group. Because this is a replace operation, you must
# specify all the grants in your request. To incrementally add or remove
# ACL grants, you might use the console.
# }
# NOT RUN {
svc$put_bucket_acl(
  Bucket = "examplebucket",
  GrantFullControl = "id=examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484",
  GrantWrite = "uri=http://acs.amazonaws.com/groups/s3/LogDelivery"
)
# }
# NOT RUN {
# }