From 2937289374f71d1160447cba7c3e421159335283 Mon Sep 17 00:00:00 2001 From: Kenneth Daily Date: Tue, 29 Jul 2025 11:29:58 -0700 Subject: [PATCH 1/3] Update retries documentation for default strategy change --- awscli/topics/config-vars.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/awscli/topics/config-vars.rst b/awscli/topics/config-vars.rst index 304d627afbb5..6131bf389c96 100644 --- a/awscli/topics/config-vars.rst +++ b/awscli/topics/config-vars.rst @@ -487,13 +487,13 @@ These configuration variables control how the AWS CLI retries requests. A string representing the type of retries the AWS CLI will perform. Value values are: - * ``legacy`` - The pre-existing retry behavior. This is default value if - no retry mode is provided. * ``standard`` - A standardized set of retry rules across the AWS SDKs. This includes a standard set of errors that are retried as well as support for retry quotas, which limit the number of unsuccessful retries an SDK can make. This mode will default the maximum number of attempts - to 3 unless a ``max_attempts`` is explicitly provided. + to 3 unless a ``max_attempts`` is explicitly provided. This is default + value if no retry mode is provided. + * ``legacy`` - The pre-existing retry behavior. * ``adaptive`` - An experimental retry mode that includes all the functionality of ``standard`` mode along with automatic client side throttling. This is a provisional mode that may change behavior in From 93321e0dcce1415376ccf25c9d9faa65d7d343a5 Mon Sep 17 00:00:00 2001 From: Kenneth Daily Date: Wed, 30 Jul 2025 09:08:14 -0700 Subject: [PATCH 2/3] Update documentation for legacy retry strategy Also add a link to the CLI user guide that gives full details on the different retry strategies. --- awscli/topics/config-vars.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/awscli/topics/config-vars.rst b/awscli/topics/config-vars.rst index 6131bf389c96..817951a6c0cc 100644 --- a/awscli/topics/config-vars.rst +++ b/awscli/topics/config-vars.rst @@ -493,12 +493,15 @@ These configuration variables control how the AWS CLI retries requests. an SDK can make. This mode will default the maximum number of attempts to 3 unless a ``max_attempts`` is explicitly provided. This is default value if no retry mode is provided. - * ``legacy`` - The pre-existing retry behavior. + * ``legacy`` - The pre-existing retry behavior. This mode will default the + maximum number of attempts to 5. * ``adaptive`` - An experimental retry mode that includes all the functionality of ``standard`` mode along with automatic client side throttling. This is a provisional mode that may change behavior in the future. +For more information, see `Available retry modes `__ +in the *AWS CLI User Guide*. Amazon S3 --------- From 5565b64c14883031b99a1164b38ab290ab9c93cc Mon Sep 17 00:00:00 2001 From: Kenneth Daily Date: Wed, 30 Jul 2025 13:35:30 -0700 Subject: [PATCH 3/3] Fix indentation of link to user guide --- awscli/topics/config-vars.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/awscli/topics/config-vars.rst b/awscli/topics/config-vars.rst index 817951a6c0cc..9cd8efc21311 100644 --- a/awscli/topics/config-vars.rst +++ b/awscli/topics/config-vars.rst @@ -500,8 +500,8 @@ These configuration variables control how the AWS CLI retries requests. throttling. This is a provisional mode that may change behavior in the future. -For more information, see `Available retry modes `__ -in the *AWS CLI User Guide*. + For more information, see `Available retry modes `__ + in the *AWS CLI User Guide*. Amazon S3 ---------