使用 AWS Systems Manager Parameter Store 时如何防止“ThrottlingException”或“超出请求率”错误？

简短描述

Parameter Store API 调用不能超过每个账户和每个 AWS 区域允许的最大 API 请求率。这包括来自 AWS 命令行界面（AWS CLI）和 AWS 管理控制台的 API 调用。如果 API 请求超过最大请求率，则您会收到“超出请求率”错误，随后的 API 调用将受到限制。您可能会看到与以下情况类似的一项错误：

• 调用 GetParameters 操作时出现错误（ThrottlingException）（已达到最大重试次数： 4）： 超出请求率
• 调用 GetParameter 操作时出现错误（ThrottlingException）（已达到最大重试次数： 4）： 超出请求率
• 调用 GetParametersByPath 操作时出现错误（ThrottlingException）（已达到最大重试次数： 4）： 超出请求率
• 调用 DescribeParameters 操作时出现错误（ThrottlingException）（已达到最大重试次数： 2）： 超出请求率

每个区域都会限制每个 Amazon Web Services（AWS）账户的 Parameter Store 请求，以帮助提高服务性能。有关 Parameter Store API 最大吞吐量限额的详细信息，请参阅 AWS Systems Manager 端点和限额。

解决方法

故障排除

要防止或缓解“ThrottlingException”或“超出请求率”错误，请尝试以下故障排除步骤：

• 降低 API 调用的频率。
• 错开 API 调用的间隔，避免其同时运行。
• 使用返回多个值的 API。例如，GetParameters 和 GetParametersByPath 支持通过一次 API 调用检索 10 个参数。
• 在进行 API 调用时实现错误重试和指数回退。
• 增加 Parameter Store 吞吐量。
  重要事项： 增加吞吐量会增加您 AWS 账户的费用开支。有关详细信息，请参阅 AWS Systems Manager 定价。
  注意： 您可以使用 AWS Systems Manager 控制台、AWS CLI 或 AWS Tools for Windows PowerShell 来提高吞吐量。如果在运行 AWS CLI 命令时收到错误，请确保您使用的是最新版本的 AWS CLI。

请求提高服务限额

如果您尝试了上述所有故障排除步骤，但仍然收到“超出请求率”错误，则可以请求提高服务限额。

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

要请求提高 Parameter Store 的服务限额，请执行以下步骤：

1. 打开 AWS Support 中心，然后选择创建案例。
2. 选择想提高服务限制？
3. 对于限制类型，选择 EC2 Systems Manager。
4. 对于区域，在请求下选择您的 AWS 区域。
5. 对于资源类型，选择 Parameter Store。
6. 选择要提高的限制，然后输入新的限制值。
7. 在用例描述文本框中，包括与节流问题相关的时间范围和请求提高限额的原因。
8. 选择您的首选联系方式，然后选择提交。

相关信息

指数回退和抖动

Parameter Store 故障排除