View a markdown version of this page

Changing Parameter Store throughput - Amazon Systems Manager
Increasing throughput using the consoleIncreasing throughput using the Amazon CLIIncreasing throughput (PowerShell)
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).

Changing Parameter Store throughput

Parameter Store throughput defines the number of API transactions per second (TPS) that Systems Manager can process for GetParameter, GetParameters, and PutParameter API calls for your Amazon Web Services account and Region. By default, Parameter Store is configured with a standard throughput quota suitable for low- to moderate-volume workloads. Applications that retrieve configuration data infrequently or operate at smaller scale can typically use this default setting without additional cost.

For higher-volume workloads, you can enable higher throughput, which increases the maximum number of supported transactions per second for your account and Region, at a cost. Increased throughput allows you to operate Parameter Store at higher volumes to support applications and workloads that need concurrent access to multiple parameters. If you're experiencing ThrottlingException: Rate exceeded errors, we recommend enabling higher throughput.

Throughput operates independently of parameter tiers, but the two are often used together to meet performance and scale requirements:

Standard parameters (default tier) are designed for most workloads. They support up to 10,000 parameters per Region, with values up to 4 KB, and incur no additional storage cost. Advanced parameters support larger values (up to 8 KB), higher parameter counts (up to 100,000), and additional features such as parameter policies. These capabilities come with additional charges.

While parameter tiers control storage limits and feature availability, throughput settings control request volume. For example, you might use standard parameters with default throughput for simple applications, or combine advanced parameters with higher throughput to support large-scale, high-frequency access patterns. In general, increasing throughput is necessary when your application exceeds default TPS limits (for example, during bursts of concurrent reads or writes), regardless of which parameter tier you use.

You can enable or disable higher throughput at any time from the Parameter Store Settings page or by using the Amazon CLI.

For more information about maximum throughput and other Parameter Store quotas, see Amazon Systems Manager endpoints and quotas.

Important

Increasing the throughput quota incurs a charge on your Amazon Web Services account. For more information, see Amazon Systems Manager Pricing.

Increasing throughput using the console

The following procedure describes how to use the Systems Manager console to increase the number of transactions per second that Parameter Store can process for the current Amazon Web Services account and Amazon Web Services Region.

To increase Parameter Store throughput using the console
Tip

If you haven't created a parameter yet, you can use the Amazon Command Line Interface (Amazon CLI) or Amazon Tools for Windows PowerShell to increase throughput. For information, see Increasing throughput using the Amazon CLI and Increasing throughput (PowerShell).

  1. Open the Amazon Systems Manager console at https://console.amazonaws.cn/systems-manager/.

  2. In the navigation pane, choose Parameter Store.

  3. Choose the Settings tab.

  4. Choose the Manage settings.

  5. In the Parameter throughput section, choose an option.

  6. If prompted, select the option to approve the changes and authorize charges. Choose Save settings.

Increasing throughput using the Amazon CLI

The following procedure shows how to use the Amazon CLI to increase the number of transactions per second that Parameter Store can process for the current Amazon Web Services account and Amazon Web Services Region.

To increase Parameter Store throughput using the Amazon CLI

  1. Open the Amazon CLI and run the following command to increase the transactions per second that Parameter Store can process in the current Amazon Web Services account and Amazon Web Services Region.

    aws ssm update-service-setting --setting-id arn:aws-cn:ssm:region:account-id:servicesetting/ssm/parameter-store/high-throughput-enabled --setting-value true

    There is no output if the command succeeds.

  2. Run the following command to view the current throughput service settings for Parameter Store in the current Amazon Web Services account and Amazon Web Services Region.

    aws ssm get-service-setting --setting-id arn:aws-cn:ssm:region:account-id:servicesetting/ssm/parameter-store/high-throughput-enabled

    The system returns information similar to the following:

    {
    "ServiceSetting": {
        "SettingId": "/ssm/parameter-store/high-throughput-enabled",
        "SettingValue": "true",
        "LastModifiedDate": 1556551683.923,
        "LastModifiedUser": "arn:aws:sts::123456789012:assumed-role/Administrator/Jasper",
        "ARN": "arn:aws:ssm:us-east-2:123456789012:servicesetting/ssm/parameter-store/high-throughput-enabled",
        "Status": "Customized"
    }
}

Increasing throughput (PowerShell)

The following procedure shows how to use the Tools for Windows PowerShell to increase the number of transactions per second that Parameter Store can process for the current Amazon Web Services account and Amazon Web Services Region.

To increase Parameter Store throughput using PowerShell

  1. Increase Parameter Store throughput in the current Amazon Web Services account and Amazon Web Services Region using the Amazon Tools for PowerShell (Tools for PowerShell).

    Update-SSMServiceSetting -SettingId "arn:aws-cn:ssm:region:account-id:servicesetting/ssm/parameter-store/high-throughput-enabled" -SettingValue "true" -Region region

    There is no output if the command succeeds.

  2. Run the following command to view the current throughput service settings for Parameter Store in the current Amazon Web Services account and Amazon Web Services Region.

    Get-SSMServiceSetting -SettingId "arn:aws-cn:ssm:region:account-id:servicesetting/ssm/parameter-store/high-throughput-enabled" -Region region

    The systems returns information similar to the following:

    ARN              : arn:aws:ssm:us-east-2:123456789012:servicesetting/ssm/parameter-store/high-throughput-enabled
LastModifiedDate : 4/29/2019 3:35:44 PM
LastModifiedUser : arn:aws:sts::123456789012:assumed-role/Administrator/Jasper
SettingId        : /ssm/parameter-store/high-throughput-enabled
SettingValue     : true
Status           : Customized