How do I prevent "ThrottlingException" or "Rate exceeded" errors when I use AWS Systems Manager Parameter Store?

3 minute read

I want to troubleshoot a "ThrottlingException" error message indicating "Rate exceeded" when using AWS Systems Manager Parameter Store.

Short description

Parameter Store API calls can't exceed the maximum allowed API request rate per account and per AWS Region. This includes API calls from both the AWS Command Line Interface (AWS CLI) and the AWS Management Console. If API requests exceed the maximum rate, then you receive a "Rate exceeded" error, and further API calls are throttled. You might see an error similar to one of the following:

  • An error occurred (ThrottlingException) when calling the GetParameters operation (reached max retries: 4): Rate exceeded
  • An error occurred (ThrottlingException) when calling the GetParameter operation (reached max retries: 4): Rate exceeded
  • An error occurred (ThrottlingException) when calling the GetParametersByPath operation (reached max retries: 4): Rate exceeded
  • An error occurred (ThrottlingException) when calling the DescribeParameters operation (reached max retries: 2): Rate exceeded

Parameter Store requests are throttled for each Amazon Web Services (AWS) account on a per-Region basis to help service performance. For more information about Parameter Store API maximum throughput quotas, see AWS Systems Manager endpoints and quotas.



To prevent or mitigate "ThrottlingException" or "Rate exceeded" errors, try the following troubleshooting steps:

Request a service quota increase

If you've tried all the preceding troubleshooting steps but still receive "Rate exceeded" errors, then you can request a service quota increase.

Note: Before submitting a request, identify the API call and call rate.

To request a service quota increase for Parameter Store, follow these steps:

  1. Open the AWS Support Center, and then choose Create case.
  2. Choose Looking for service limit increases?
  3. For Limit type, choose EC2 Systems Manager.
  4. For Region, choose your AWS Region under Requests.
  5. For Resource Type, choose Parameter Store.
  6. Choose the Limit that you want to increase, and then enter the new limit value.
  7. In the Use case description text box, include the time frame related to the throttling issue and the reason for the quota increase request.
  8. Choose your preferred contact options, and then choose Submit.

Related information

Exponential backoff and jitter

Troubleshooting Parameter Store

AWS OFFICIALUpdated a year ago