retry_mode - AWS SDKs and Tools Shared Configuration and Credentials


Specifies how the SDK or developer tool attempts retries.


Default value: legacy

Valid values:

  • legacy – The current preexisting retry behavior.

  • standard – The standard set of retry rules across AWS SDKs. This mode includes a standard set of errors that are retried, and support for retry quotas. The default number of retry attempts with this mode is three, unless max_attempts is explicitly configured.

  • adaptive – An experimental retry mode that includes the functionality of standard mode but includes automatic client-side throttling. Because this mode is experimental, it might change behavior in the future.

Ways to set this value

Location Supported Example
config file X
credentials file -
Environment variable X AWS_RETRY_MODE
CLI parameter -

Compatibility with AWS SDKS and tools