AWS AmazonS3: Reformat PutBucketAcl example and link ACL docs
Summary
Reformatted the put-bucket-acl CLI example into a multi-line command and added a link to ACL configuration guidance.
Security assessment
The added text documents an ACL example that grants public read access; this is security-relevant, but the diff is only formatting/linking and does not address a specific vulnerability.
Evidence
The following `put-bucket-acl` example grants `full control` to two AWS users ([email protected]_ and [email protected]_) and `read` permission to everyone.
Diff
diff --git a/AmazonS3/latest/developerguide/s3_example_s3_PutBucketAcl_section.md b/AmazonS3/latest/developerguide/s3_example_s3_PutBucketAcl_section.md index 7c6cf04..961b2f3 100644 --- a//AmazonS3/latest/developerguide/s3_example_s3_PutBucketAcl_section.md +++ b//AmazonS3/latest/developerguide/s3_example_s3_PutBucketAcl_section.md @@ -187 +187 @@ CLI -This example grants `full control` to two AWS users ([email protected]_ and [email protected]_) and `read` permission to everyone: +**To set the access control list for a bucket** @@ -188,0 +189 @@ This example grants `full control` to two AWS users ([email protected]_ and _us +The following `put-bucket-acl` example grants `full control` to two AWS users ([email protected]_ and [email protected]_) and `read` permission to everyone. @@ -190 +190,0 @@ This example grants `full control` to two AWS users ([email protected]_ and _us - aws s3api put-bucket-acl --bucket amzn-s3-demo-bucket --grant-full-control [email protected],[email protected] --grant-read uri=http://acs.amazonaws.com/groups/global/AllUsers @@ -191,0 +192,4 @@ This example grants `full control` to two AWS users ([email protected]_ and _us + aws s3api put-bucket-acl \ + --bucket amzn-s3-demo-bucket \ + --grant-full-control [email protected],[email protected] \ + --grant-read uri=http://acs.amazonaws.com/groups/global/AllUsers @@ -193 +197,4 @@ This example grants `full control` to two AWS users ([email protected]_ and _us -See http://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTacl.html for details on custom ACLs (the s3api ACL commands, such as `put-bucket-acl`, use the same shorthand argument notation). + +This command produces no output. + +For more information, see [Configuring ACLs](https://docs.aws.amazon.com/AmazonS3/latest/userguide/managing-acls.html) in the _Amazon S3 User Guide_.