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

Last updated: 2021-03-12

When I use AWS Systems Manager Parameter Store, I receive a "ThrottlingException" error message indicating "Rate exceeded" 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

Why am I receiving "Rate exceeded" errors, and how can I resolve the issue?

Short description

Parameter Store API calls can't exceed the maximum allowed API request rate per account and per 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.

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.

Resolution

Troubleshooting

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 above 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 Service limit increase.
  3. For Limit type, choose EC2 Systems Manager.
  4. For Region, choose your AWS Region.
  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.

Did this article help?


Do you need billing or technical support?