From df8554981f6aa1e7f68e98435b9569f726b46156 Mon Sep 17 00:00:00 2001 From: veradri Date: Fri, 14 Nov 2025 15:54:12 -0800 Subject: [PATCH 1/5] 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 #9479 --- awscli/topics/s3-config.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/awscli/topics/s3-config.rst b/awscli/topics/s3-config.rst index c7979d230bcc..2a64ed80b894 100644 --- a/awscli/topics/s3-config.rst +++ b/awscli/topics/s3-config.rst @@ -15,6 +15,11 @@ are provided in the case where you need to modify one of these values, either for performance reasons or to account for the specific environment where these ``aws s3`` commands are being run. +.. warning:: + S3 commands have a parameter ``--endpoint-url`` that overrides the command's + default URL with the given URL. Avoid using the S3 Global Endpoint + (s3.amazonaws.com) as the value for this parameter to prevent redirect + issues and other unintended behavior or errors from S3. Configuration Values ==================== From 5db0a467e781d6a45eeac2523e30ae2527da97e7 Mon Sep 17 00:00:00 2001 From: veradri Date: Mon, 17 Nov 2025 10:18:28 -0800 Subject: [PATCH 2/5] docs: warn against using s3.amazonaws.com as endpoint-url Add warning to S3 configuration docs advising against using the global S3 endpoint (s3.amazonaws.com) as --endpoint-url parameter value to prevent PermanentRedirect errors and other unwanted behaviors/errors from S3 Addresses #9479 --- awscli/topics/s3-config.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/awscli/topics/s3-config.rst b/awscli/topics/s3-config.rst index 2a64ed80b894..aa26d3e26de1 100644 --- a/awscli/topics/s3-config.rst +++ b/awscli/topics/s3-config.rst @@ -18,7 +18,7 @@ for performance reasons or to account for the specific environment where these .. warning:: S3 commands have a parameter ``--endpoint-url`` that overrides the command's default URL with the given URL. Avoid using the S3 Global Endpoint - (s3.amazonaws.com) as the value for this parameter to prevent redirect + (``https://s3.amazonaws.com``) as the value for this parameter to prevent redirect issues and other unintended behavior or errors from S3. Configuration Values From 8bfa3900f40cc61a972901a851140fe92691768c Mon Sep 17 00:00:00 2001 From: veradri Date: Thu, 20 Nov 2025 09:46:40 -0800 Subject: [PATCH 3/5] Docs: improve S3 endpoint-url guidance with note format Move endpoint-url warning from warning block to note format and relocate to appropriate section based on code review feedback. Add reference to AWS service-specific endpoints documentation. Addresses #9479 Refactor the S3 endpoint-url guidance based on review feedback: - Change from warning block to note format - Add reference to official AWS service-specific endpoints guide - Improve clarity of when to use endpoint-url with appropriate actions - Maintain focus on preventing redirect issues and unintended behavior This addresses the original issue while incorporating reviewer suggestions for better placement and formatting of the guidance. --- awscli/topics/s3-config.rst | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/awscli/topics/s3-config.rst b/awscli/topics/s3-config.rst index aa26d3e26de1..def0e53e877a 100644 --- a/awscli/topics/s3-config.rst +++ b/awscli/topics/s3-config.rst @@ -15,11 +15,13 @@ are provided in the case where you need to modify one of these values, either for performance reasons or to account for the specific environment where these ``aws s3`` commands are being run. -.. warning:: - S3 commands have a parameter ``--endpoint-url`` that overrides the command's - default URL with the given URL. Avoid using the S3 Global Endpoint - (``https://s3.amazonaws.com``) as the value for this parameter to prevent redirect - issues and other unintended behavior or errors from S3. +.. note:: + `S3 high-level commands `_ provide an option to use a custom endpoint using ``--endpoint-url``. + This overrides the default endpoint the command will use. + Use caution when configuring this parameter, as it can cause S3 redirect issues and + unintended behavior. This parameter is intended for VPC endpoints and other S3 specialized configurations. + For more information about endpoint configuration, + see `Service-specific endpoints `_. Configuration Values ==================== From 2390eca05aa07daef2b25e0f8c083fc5ac3a0d54 Mon Sep 17 00:00:00 2001 From: veradri Date: Fri, 28 Nov 2025 09:43:21 -0800 Subject: [PATCH 4/5] Rephrase endpoint_url documentation wording Improved clarity and readability of the endpoint_url parameter documentation for S3 commands. --- awscli/topics/s3-config.rst | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/awscli/topics/s3-config.rst b/awscli/topics/s3-config.rst index def0e53e877a..3c26aae5322c 100644 --- a/awscli/topics/s3-config.rst +++ b/awscli/topics/s3-config.rst @@ -16,12 +16,10 @@ for performance reasons or to account for the specific environment where these ``aws s3`` commands are being run. .. note:: - `S3 high-level commands `_ provide an option to use a custom endpoint using ``--endpoint-url``. + S3 commands have an option to use a custom endpoint using ``--endpoint-url``. This overrides the default endpoint the command will use. - Use caution when configuring this parameter, as it can cause S3 redirect issues and - unintended behavior. This parameter is intended for VPC endpoints and other S3 specialized configurations. - For more information about endpoint configuration, - see `Service-specific endpoints `_. + Use caution when configuring this parameter as it can cause S3 unintended behavior including S3 redirect issues. + See `Service-specific endpoints `_ page in the *AWS SDK reference guide* for more information. Configuration Values ==================== From c51d3027cffb2bfd9b8dbb08dd8ad68d7088fe28 Mon Sep 17 00:00:00 2001 From: "Adrian D." <101290859+adev-code@users.noreply.github.com> Date: Wed, 10 Dec 2025 13:45:23 -0800 Subject: [PATCH 5/5] Update awscli/topics/s3-config.rst Co-authored-by: Kenneth Daily --- awscli/topics/s3-config.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/awscli/topics/s3-config.rst b/awscli/topics/s3-config.rst index 3c26aae5322c..c976aac38f4b 100644 --- a/awscli/topics/s3-config.rst +++ b/awscli/topics/s3-config.rst @@ -18,7 +18,7 @@ for performance reasons or to account for the specific environment where these .. note:: S3 commands have an option to use a custom endpoint using ``--endpoint-url``. This overrides the default endpoint the command will use. - Use caution when configuring this parameter as it can cause S3 unintended behavior including S3 redirect issues. + Use caution when configuring this parameter as it can cause unintended behavior including S3 redirect issues. See `Service-specific endpoints `_ page in the *AWS SDK reference guide* for more information. Configuration Values