使用 Parameter Store 时，如何防止出现提示“Rate exceeded”（超出请求率）的“ThrottlingException”错误？

简短描述

Parameter Store API 调用不能超过每个 AWS 账户和每个 AWS 区域允许的最大 API 请求率。允许的最大速率包括来自 AWS 命令行界面 (AWS CLI) 和 AWS 管理控制台的 API 调用。

如果 API 请求超过最大速率，则您可能会看到一条类似于以下内容之一的错误消息：

• "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 对每个账户和区域的请求进行了限制。有关 Parameter Store API 最大吞吐量配额的详细信息，请参阅 Parameter Store 服务配额。

解决方法

**注意：**如果您在运行 AWS CLI 命令时收到错误，请参阅 AWS CLI 错误故障排除。此外，请确保您使用的是最新版本的 AWS CLI。

故障排除

要防止出现包含“Rate exceeded”（超过请求率）的“ThrottlingException”错误消息，请采取以下操作：

• 降低 API 调用的频率。
• 设置 API 调用的间隔，避免其同时运行。
• 使用返回多个值的 API。例如，GetParameters 和 GetParametersByPath 可以通过一次 API 调用检索 10 个参数。
• 在进行 API 调用时实现错误重试和指数回退。有关说明，请参阅重试行为。
• 如果您使用 AWS Lambda 对 Parameter Store 执行 API 调用，请缓存您的参数。
• 增加 Parameter Store 吞吐量。
  **重要事项：**当您增加吞吐量时，您的账户会产生费用。有关详细信息，请参阅 AWS Systems Manager 定价。

请求提高服务配额

如果您尝试了上述所有故障排除方法，但仍然收到“Rate exceeded”（超出请求率）错误，您可以请求提高服务配额。

**注意：**在提交请求之前，请确定 API 调用和调用率。

要请求提高 Parameter Store 的服务配额，请完成以下步骤：

1. 打开 AWS Support Center 控制台，然后选择 Create case（创建案例）。
2. 选择 Looking for service limit increases?（希望提高服务限制？）。
3. 对于 Limit type（限制类型），选择 EC2 Systems Manager。
4. 对于 Region（区域），在 Requests（请求）下选择您的区域。
5. 对于 Resource Type（资源类型），选择 Parameter Store。
6. 对于 Quota（配额），选择一个项目，然后在 Use case description（用例描述）文本框中描述您的 API 配额增加的原因。
   **注意：**对于每秒 API 调用的最大交易，没有适用的项目。
7. 输入新的配额值。
8. 在 Use case description（用例描述）文本框中，包括与节流问题相关的时间范围和请求提高配额的原因。
9. 选择您的首选联系方式，然后选择 Submit（提交）。

相关信息

指数回退和抖动

Parameter Store 故障排除