[Documentation] Warning against the use of S3 Global Endpoint (s3.amazonaws.com) as endpoint-url
Summary
Adds documentation improvements to S3 configuration documentation (in the AWS CLI) for the --endpoint-url parameter:
-
Warning against S3 Global endpoint: Advises users to avoid using
https://s3.amazonaws.comorhttp://s3.amazonaws.comas the --endpoint-url parameter value, as it can cause PermanentRedirect errors and configuration confusion. -
General endpoint_url guidance: Adds a note explaining the --endpoint-url parameter usage, including caution about S3 unintended behavior such as S3 redirect issues. References the AWS SDK reference guide for additional endpoint configuration information.
Testing
• [x] Documentation builds successfully with make html • [x] Warning and note display correctly in generated docs
Addresses #9479
This might be a good place to point customers to:
https://docs.aws.amazon.com/sdkref/latest/guide/feature-ss-endpoints.html