aws-cli icon indicating copy to clipboard operation
aws-cli copied to clipboard

[Documentation] Warning against the use of S3 Global Endpoint (s3.amazonaws.com) as endpoint-url

Open adev-code opened this issue 1 month ago • 1 comments

Summary

Adds documentation improvements to S3 configuration documentation (in the AWS CLI) for the --endpoint-url parameter:

  1. Warning against S3 Global endpoint: Advises users to avoid using https://s3.amazonaws.com or http://s3.amazonaws.com as the --endpoint-url parameter value, as it can cause PermanentRedirect errors and configuration confusion.

  2. 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

Screenshot 2025-11-28 at 9 40 03 AM

Addresses #9479

adev-code avatar Nov 17 '25 18:11 adev-code

This might be a good place to point customers to:

https://docs.aws.amazon.com/sdkref/latest/guide/feature-ss-endpoints.html

kdaily avatar Nov 18 '25 18:11 kdaily