Announcement: Updated default retry behavior (2026)

> This issue tracks the 2026 retry updates for AWS Tools for PowerShell. See the [announcement blog post](https://aws.amazon.com/blogs/developer/announcing-updated-retry-behavior-for-aws-sdks-and-tools/) for the full story across all AWS SDKs, including how to tell if you are affected.

## Status

|||
|-|-|
|**Opt-in available in**|`AWS.Tools.Common` version `5.0.202` and later|
|**Opt-in flag**|`AWS_NEW_RETRIES_2026=true`|
|**Default rollout**|No sooner than November 2026|

## What changed

When you set `AWS_NEW_RETRIES_2026=true`, the retry defaults within `standard` mode update. The retry mode itself does not change.

If you have explicitly configured max attempts or backoff, your value takes precedence for that setting.

|Setting|Before|After|
|-|-|-|
|Transient (non-throttling) base delay|1,000 ms|**50 ms**|
|Throttling base delay|1,000 ms|**1,000 ms (unchanged)**|
|Max attempts|3|**3 (unchanged)**|
|Transient retry quota cost|5 tokens|**14 tokens**|
|**DynamoDB and DynamoDB Streams**|||
|Transient (non-throttling) base delay|1,000 ms|**25 ms**|
|Throttling base delay|1,000 ms|**1,000 ms (unchanged)**|
|Max attempts|10|**4**|

> DynamoDB defaults use a shorter base delay to match its low-latency profile. The additional attempt keeps the last retry's maximum backoff comparable to the general default.

Transient errors (such as 500s and connection resets) now use a much shorter backoff than throttling errors (where the service asks you to slow down). For details on backoff timing, error classification, and the retry quota, see [Retry behavior in the AWS SDKs](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html#how-retries-work). For retry mode selection and configuration options, see [Retry behavior in the AWS SDKs](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html#configuring-retries).

## How to opt in

Update to `AWS.Tools.Common` version `5.0.202` or later, then set the environment variable:

```powershell
$env:AWS_NEW_RETRIES_2026 = "true"
```

Bash:

```bash
export AWS_NEW_RETRIES_2026=true
```

Windows CMD:

```cmd
set AWS_NEW_RETRIES_2026=true
```

## How to revert

During the opt-in period, remove the environment variable:

```powershell
Remove-Item Env:AWS_NEW_RETRIES_2026
```

After the default rollout (no sooner than November 2026), the `AWS_NEW_RETRIES_2026` flag will be removed. The updated behavior cannot be reverted because this SDK does not support `legacy` retry mode. You can still override `max_attempts`.

If this is a concern for your use case, please let us know in this issue.

## Where you might notice a difference

For most workloads, the change is invisible or strictly better. Transient errors recover faster because the base delay is significantly shorter.

* **Retry quota activates sooner for transient errors.** Each transient retry costs 14 tokens (previously 5 for most errors). During sustained transient failures (such as 500s and connection resets), the retry quota triggers at a lower failure rate than the previous version of standard mode. Throttling retries cost 5 tokens.
* **Long-polling operations now back off when the retry quota is depleted.** Operations like `SQS.ReceiveMessage` apply a backoff delay before returning an error, even when retries are blocked. Without this, polling loops tighten during outages, spiking client CPU usage and generating additional load that can delay recovery. For details, see [long-polling operations](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html#long-polling-operations).

## Overriding specific settings

You do not have to accept all changes as a bundle. If you opt in but want to keep a specific previous value, set it explicitly. Precedence applies per setting.

For example, to use the new backoff timing but keep a higher DynamoDB max attempts:

```powershell
$ddbConfig = New-Object -TypeName Amazon.DynamoDBv2.AmazonDynamoDBConfig
$ddbConfig.MaxErrorRetry = 9

Get-DDBTable -TableName -ClientConfig $ddbConfig
```

For the full list of configurable settings and their precedence, see [Retry behavior in the AWS SDKs](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html#configuring-retries).

## Feedback

If you encounter unexpected behavior or have questions, comment on this issue. Your feedback during the opt-in period directly shapes when and how we make this the default.

Start with the linked announcement and the AWS SDK retry-behavior references; the issue names AWS.Tools.Common 5.0.202, the AWS_NEW_RETRIES_2026 flag, and the documented retry values. No source file or test is named, and completion is unclear because this issue requests feedback rather than specifying a code or documentation change.

Written by the indexing model from the issue text.