Skip to content

Commit df85549

Browse files
committed
Warn against S3 global endpoint usage
Add warning to S3 configuration documentation advising users to avoid using s3.amazonaws.com as the --endpoint-url parameter value to prevent PermanentRedirect errors and configuration confusion. This addresses user issues where setting the global S3 endpoint as a custom endpoint URL causes redirect loops and unexpected behavior. Addresses aws#9479
1 parent 6889732 commit df85549

1 file changed

Lines changed: 5 additions & 0 deletions

File tree

awscli/topics/s3-config.rst

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,11 @@ are provided in the case where you need to modify one of these values, either
1515
for performance reasons or to account for the specific environment where these
1616
``aws s3`` commands are being run.
1717

18+
.. warning::
19+
S3 commands have a parameter ``--endpoint-url`` that overrides the command's
20+
default URL with the given URL. Avoid using the S3 Global Endpoint
21+
(s3.amazonaws.com) as the value for this parameter to prevent redirect
22+
issues and other unintended behavior or errors from S3.
1823

1924
Configuration Values
2025
====================

0 commit comments

Comments
 (0)