TrueCloudLab
/
frostfs-s3-gw
16
2
Fork 14
Code Issues 19 Pull Requests 6 Actions Packages Releases 7 Activity

[#732] docs: Clarify some outputs of bucket creation 

Add description with interpretation of some AWS CLI outputs occurred
during bucket creation.

Signed-off-by: Leonard Lyubich <ctulhurider@gmail.com>
remotes/KirillovDenis/feature/685-acl_chunks
Leonard Lyubich 2022-10-28 12:20:05 +04:00 committed by Alex Vanin
parent 7bbbda6b7e
commit f6b94c25c5
1 changed files with 10 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
docs/aws_cli.md
View File

@ -44,6 +44,16 @@ $ aws s3api create-bucket --bucket %BUCKET_NAME --acl %ACL
where `%ACL` can be represented by a hex encoded value or by keywords `public-read-write`, `private`, `public-read`.
If the parameter is not set, the default value is `private`.
> **_NOTE:_** Bucket creation uses async-poll approach. `BucketAlreadyOwnedByYou`
> status can occur if the AWS CLI makes multiple attempts (see details
> in [docs](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-retries.html)).
> This status means successful bucket creation after several tries. When the
> operation has not been completed in the entire wait time, timeout status outputs.
> Timeout does not always mean failure of the operation: success can be checked
> later by bucket getting/listing commands, or by repeating the creating command
> (previous success will result in the status mentioned above). It is worth clarifying
> that the final success of the bucket creation is not guaranteed after a timeout error.
#### Deletion of a bucket
To delete a bucket, execute the following command: