From f6b94c25c5f84857789af1599e19683ba44d4769 Mon Sep 17 00:00:00 2001 From: Leonard Lyubich Date: Fri, 28 Oct 2022 12:20:05 +0400 Subject: [PATCH] [#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 --- docs/aws_cli.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/aws_cli.md b/docs/aws_cli.md index 03a3ec245..cc03f2c1e 100644 --- a/docs/aws_cli.md +++ b/docs/aws_cli.md @@ -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: