Applies or updates an ACL on a bucket, setting permissions for specific users, groups, or the public.

Stored Procedure-Specific Information

This procedure applies an ACL to a bucket. You can set access in two ways: supply a canned ACL through the ACL input (for example, private or public-read) or the individual grant inputs (GrantFullControl, GrantRead, GrantReadAcp, GrantWrite, and GrantWriteAcp), or supply a full AccessControlPolicy XML document to define grants and grantees explicitly.

The following example grants public read access to a bucket:

EXECUTE PutBucketAcl
     @Bucket='BucketName',
     @ACL='public-read'

Input

Name	Type	Required	Description
AccessControlPolicy	String	False	The XML structure that defines the access control policy (including grants and grantees) to apply to the bucket.
Bucket	String	True	The name of the S3 bucket to which the ACL will be applied.
ACL	String	False	A predefined (canned) ACL setting, such as private, public-read, or authenticated-read, to quickly configure access permissions.
GrantFullControl	String	False	Grants the specified AWS account full control over the bucket, including read, write, read ACL, and write ACL permissions.
GrantRead	String	False	Grants the specified AWS account permission to list the objects in the bucket.
GrantReadAcp	String	False	Grants the specified AWS account permission to read the ACL of the bucket.
GrantWrite	String	False	Grants the specified AWS account permission to create new objects within the bucket.
GrantWriteAcp	String	False	Grants the specified AWS account permission to write or modify the ACL of the bucket.
ExpectedBucketOwner	String	False	The AWS account ID expected to own the bucket. The request fails if the actual owner does not match.

Result Set Columns

Name	Type	Description
Status	String	Indicates the result of the ACL update operation, such as success or failure.