AWS AmazonS3: Reformat S3 put-object-acl example and update ACL doc link
Summary
Reformats the put-object-acl CLI example (multi-line command), adds a 'To set the access control list for an object' heading, and replaces the old RESTBucketPUTacl link with a link to the ACL overview in the S3 User Guide.
Security assessment
The change is purely editorial: it reformats the example command and swaps a documentation link. The example still demonstrates granting public read via --grant-read uri=.../AllUsers, but this behavior is unchanged and no vulnerability or fix is addressed.
Evidence
+For more information, see [Access control list (ACL) overview](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html) in the _Amazon S3 User Guide_.
Diff
diff --git a/AmazonS3/latest/developerguide/s3_example_s3_PutObjectAcl_section.md b/AmazonS3/latest/developerguide/s3_example_s3_PutObjectAcl_section.md index 4c6ee0c..7c16a12 100644 --- a//AmazonS3/latest/developerguide/s3_example_s3_PutObjectAcl_section.md +++ b//AmazonS3/latest/developerguide/s3_example_s3_PutObjectAcl_section.md @@ -132 +132 @@ CLI -The following command grants `full control` to two AWS users ([email protected]_ and [email protected]_) and `read` permission to everyone: +**To set the access control list for an object** @@ -133,0 +134 @@ The following command grants `full control` to two AWS users ([email protected] +The following `put-object-acl` example grants `full control` to two AWS users ([email protected]_ and [email protected]_) and `read` permission to everyone. @@ -135 +135,0 @@ The following command grants `full control` to two AWS users ([email protected] - aws s3api put-object-acl --bucket amzn-s3-demo-bucket --key file.txt --grant-full-control [email protected],[email protected] --grant-read uri=http://acs.amazonaws.com/groups/global/AllUsers @@ -136,0 +137,5 @@ The following command grants `full control` to two AWS users ([email protected] + aws s3api put-object-acl \ + --bucket amzn-s3-demo-bucket \ + --key file.txt \ + --grant-full-control [email protected],[email protected] \ + --grant-read uri=http://acs.amazonaws.com/groups/global/AllUsers @@ -138 +143,4 @@ The following command grants `full control` to two AWS users ([email protected] -See http://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTacl.html for details on custom ACLs (the s3api ACL commands, such as `put-object-acl`, use the same shorthand argument notation). + +This command produces no output. + +For more information, see [Access control list (ACL) overview](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html) in the _Amazon S3 User Guide_.