

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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_tw/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** 增加 的 DNS 命名空間 AWS Cloud Map 執行個體需要增加每個託管區域 Route 53 限制的記錄，這會產生額外費用。

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

AWS Cloud Map 已與 Service Quotas 整合，這項 AWS 服務可讓您從中央位置檢視和管理配額。如需詳細資訊，請參閱《*Service Quotas 使用者指南*》中的[「什麼是 Service Quotas？」](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html)。

Service Quotas 可讓您輕鬆地查詢 AWS Cloud Map 服務配額的值。

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

**使用 檢視 AWS Cloud Map 服務配額 AWS 管理主控台**

1. 開啟 Service Quotas 主控台，網址為 [https://console.aws.amazon.com/servicequotas/](https://console.aws.amazon.com/servicequotas/)。

1. 在導覽窗格中，選擇 **AWS services** (AWS 服務)。

1. 從 **AWS services** (AWS 服務) 清單中，搜尋並選取 **AWS Cloud Map**。

1. 在 的服務配額清單中 AWS Cloud Map，您可以看到服務配額名稱、套用值 （如果有的話）、 AWS 預設配額，以及配額值是否可以調整。

   若要檢視服務配額的其他資訊，例如描述，請選擇配額名稱以調出配額詳細資訊。

1. （選用） 若要請求增加配額，請選取您要增加的配額，然後在**帳戶層級選擇請求增加**。

若要使用 進一步使用服務配額， AWS 管理主控台 請參閱 [Service 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，請參閱 [Service 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) 命令。

------

# Handle 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 請求。調節有助於改善服務的效能，並協助為所有 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 個字符。如果您在一秒內提出 2，000 個 [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) 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>

您可以請求提高 AWS 帳戶的 API 限流配額。若要請求調節配額，請聯絡 [AWS 支援 中心](https://console.aws.amazon.com/support/home#/)。