

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# AWS Cloud Map 服务配额
<a name="cloud-map-limits"></a>

AWS Cloud Map 资源受以下账户级别服务配额的约束。列出的每个配额都适用于您创建 AWS Cloud Map 资源的每个 AWS 区域。

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/cloud-map/latest/dg/cloud-map-limits.html)

**\$1** 当您创建命名空间时，我们会自动创建 Amazon Route 53 托管区域。此托管区域计入您可以使用 AWS 账户创建的托管区域数量的配额。有关更多信息，请参阅 *Amazon Route 53 开发人员指南*中的[托管区域的配额](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DNSLimitations.html#limits-api-entities-hosted-zones)。

**\$1\$1** 为 AWS Cloud Map 增加 DNS 命名空间的实例需要提高每个托管区 Route 53 的记录限制，这会产生额外费用。

# 管理您的 AWS Cloud Map 服务配额
<a name="service-quotas-manage"></a>

AWS Cloud Map 已与 Service Quotas 集成，Service Quotas 是一项使您能够从中央位置查看和管理配额的 AWS 服务。有关更多信息，请参阅《服务限额用户指南》中的[什么是服务限额？](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html)

Service Quotas 可以轻松查询 AWS Cloud Map 服务配额的价值。

------
#### [ AWS 管理控制台 ]

**要查看 AWS Cloud Map 服务配额，请使用 AWS 管理控制台**

1. 在 [https://console.aws.amazon.com/servicequotas/](https://console.aws.amazon.com/servicequotas/) 打开 Service Quotas 控制台。

1. 在导航窗格中，选择 **AWS 服务**。

1. 从 **AWS 服务**列表中，搜索并选择 **AWS Cloud Map**。

1. 在的服务配额列表中 AWS Cloud Map，您可以看到服务配额名称、应用的值（如果可用）、 AWS 默认配额以及配额值是否可调整。

   要查看有关服务配额的其他信息（例如描述），请选择配额名称以显示配额详细信息。

1. （可选）要申请增加配额，请选择要增加的配额，然后选择**在账户级别申请增加**配额。

要更多地使用服务配额， AWS 管理控制台 请参阅 Ser [vice Quotas 用户指南](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html)。

------
#### [ AWS CLI ]

**要查看 AWS Cloud Map 服务配额，请使用 AWS CLI**  
运行以下命令以查看默认 AWS Cloud Map 配额。

```
aws service-quotas list-aws-default-service-quotas \
    --query 'Quotas[*].{Adjustable:Adjustable,Name:QuotaName,Value:Value,Code:QuotaCode}' \
    --service-code AWSCloudMap \
    --output table
```

运行以下命令以查看您已应用的 AWS Cloud Map 配额。

```
aws service-quotas list-service-quotas \
    --service-code AWSCloudMap
```

有关使用服务配额的更多信息 AWS CLI，请参阅 Serv [ice Quotas AWS CLI 命令参考](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/#cli-aws-service-quotas)。要请求提高配额，请参阅 [AWS CLI 命令参考](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/#cli-aws-service-quotas)中的 [https://docs.aws.amazon.com/cli/latest/reference/service-quotas/request-service-quota-increase.html](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/request-service-quota-increase.html) 命令。

------

# 处理 AWS Cloud Map DiscoverInstances API 请求限制
<a name="throttling"></a>

AWS Cloud Map 按区域限制每个 AWS 账户的 [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API 请求。Throttling 有助于提高服务的性能，并有助于为所有 AWS Cloud Map 客户提供公平使用服务。限制可确保对 AWS Cloud Map [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API 的调用不会超过允许的最大 [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API 请求配额。 [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)来自以下任何来源的 API 调用均受请求配额的限制：
+ 第三方应用程序
+ 命令行工具
+ 控制 AWS Cloud Map 台

如果您超过 API 节流配额，则会收到`RequestLimitExceeded`错误代码。有关更多信息，请参阅 [请求速率限制](#throttling-rate-based)。

## 如何应用节流
<a name="throttling-how"></a>

AWS Cloud Map 使用令[牌桶算法](https://en.wikipedia.org/wiki/Token_bucket)实现 API 限制。使用此算法，您的账户拥有一个持有特定数量的*令牌*的*存储桶*。存储桶中的令牌数表示您在任何给定秒钟的节流配额。单个区域有一个存储桶，它适用于该区域的所有端点。

### 请求速率限制
<a name="throttling-rate-based"></a>

限流限制了您可以发出的 [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API 请求的数量。每个请求都会从存储桶中删除一个令牌。例如，[DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API 操作的存储桶大小为 2,000 个令牌，因此您最多可以在一秒钟内发出 2,000 个[DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)请求。如果您在一秒钟内超过 2,000 个请求，则会被节流，而该秒内剩余的请求将失败。

存储桶会以设定的速率自动填充。如果存储桶容量不足，则每秒添加一定数量的令牌，直到存储桶达到容量。如果重填令牌到达时存储桶已满，这些令牌将被丢弃。[DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API 操作的存储桶大小为 2,000 个令牌，充值速率为每秒 1,000 个令牌。如果您在一秒钟内发[DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)出 2,000 个 API 请求，则存储桶会立即减少为零 (0) 个令牌。然后，该存储桶每秒最多可重填 1,000 个令牌，直至达到其 2,000 个令牌的最大容量。

您可以在令牌被添加到存储桶时使用这些令牌。在发出 API 请求之前，您无需等待存储桶达到最大容量。如果您在一秒钟内发出 2,000 个 [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API 请求来耗尽存储桶，那么在此之后您仍然可以根据需要每秒发出 1,000 个 [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API 请求。这意味着当重填令牌被添加到存储桶时，您可以立即使用这些令牌。只有当您每秒发出的 API 请求数少于重填速率时，存储桶才会开始重填到最大容量。

### 重试或批处理
<a name="retries"></a>

如果 API 请求失败，您的应用程序可能需要重试该请求。要减少 API 请求数，请在连续的请求之间添加相应的睡眠间隔。为了获得最佳的效果，请使用递增或可变的睡眠间隔。

### 计算睡眠间隔
<a name="calculate_delay_interval"></a>

在需要轮询或重试 API 请求时，我们建议您使用指数回退算法计算 API 调用之间的睡眠间隔。通过在两次重试之间逐渐延长连续错误响应的等待时间，您可以减少失败请求的数量。有关此算法的更多信息和实现示例，请参阅《*AWS SDKs 和工具参考指南》*中的 “[重试行为](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html)”。

## 调整 API 节流配额
<a name="throttling-increase"></a>

您可以申请增加账户的 API 限制配 AWS 额。要请求配额调整，请联系 [AWS 支持 中心](https://console.aws.amazon.com/support/home#/)。