Configuring automatic retry for throttled operations - Amazon Systems Manager
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Configuring automatic retry for throttled operations

There is a limit on the number of concurrent automation executions that can run in each account. Attempting to run several automations concurrently in an account can lead to throttling issues. You can use the automatic throttling retry capability to configure retry behavior for throttled automation steps.

Automatic throttling retry for automation actions provides a more resilient execution environment for high-scale operations. The throttling retry capability supports all automation actions except for aws:executeScript.

The throttling retry setting works in addition to the existing maxAttempts step property. When both are configured, the system first attempts throttling retries within the specified time limit, then applies the maxAttempts setting if the step continues to fail.

To configure throttling retry using the Amazon Web Services Management Console
  1. Open the Amazon Systems Manager console at https://console.amazonaws.cn/systems-manager/.

  2. In the navigation pane, choose Automation.

  3. Choose the Preferences tab, and then choose Edit.

  4. In the Throttling retry time limit field, enter a value between 0 and 3600 seconds. This specifies the maximum time that the system retries a step that is throttled.

  5. Choose Save.

To configure throttling retry using the command line
  • Open the Amazon CLI or Tools for Windows PowerShell and run the following command to configure throttling retry for your account in the requesting Region.

    Linux & macOS
    aws ssm update-service-setting \ --setting-id /ssm/automation/throttling-retry-time-limit \ --setting-value 3600
    Windows
    aws ssm update-service-setting ^ --setting-id /ssm/automation/throttling-retry-time-limit ^ --setting-value 3600
    PowerShell
    Update-SSMServiceSetting ` -SettingId "/ssm/automation/throttling-retry-time-limit" ` -SettingValue "3600"