当我使用 AWS Systems Manager Parameter Store 时，如何防止“ThrottlingException”或“Rate exceeded”错误？

简短描述

Parameter Store API 调用不能超过每个账户和每个区域允许的最大 API 请求速率。这包括来自 AWS 命令行界面 (AWS CLI) 和 AWS 管理控制台的 API 调用。如果 API 请求超出最大速率，您会收到“超出速率”错误，并且未来的 API 调用会受限。

按每个区域限制每个 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 中心，然后选择 Create case（创建案例）。
2. 选择 Service limit increase（提高服务限额）。
3. 对于 Limit type（限制类型），选择 EC2 Systems Manager.
4. 对于 Region（区域），选择您的 AWS 区域。
5. 对于 Resource Type（资源类型），选择 Parameter Store。
6. 选择您想要提高的限制，然后输入新限制值。
7. 在 Use case description（使用案例描述）文本框中，包含与限制问题相关的时间范围和提高配额请求的原因。
8. 选择首选联系方式选项，然后选择 Submit（提交）。

---

相关信息

指数回退和抖动

对 Parameter Store 进行故障排除