

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

# 配額和限制
<a name="service-sizes-and-limits"></a>

下表說明 Amazon Kinesis Data Streams 的串流和碎片配額和限制。


****  

| 配額 | 隨需模式 | 佈建模式 | 
| --- | --- | --- | 
|  資料串流數目 | 您 AWS 帳戶中的串流數量沒有上限配額。根據預設，透過使用隨需容量模式，您可以建立最多 50 個資料串流。如果您需要提高此配額，請提出[支援票證](https://support.console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase)。 | 帳戶中佈建模式的串流數量沒有上限配額。 | 
|  碎片數量 | 沒有上限。碎片數目取決於擷取的資料量和您所需要的輸送量層級。Kinesis Data Streams 會自動擴展碎片數目，以回應資料量和流量的變更。 |  沒有上限。下列 AWS 帳戶 項目的預設碎片配額為每個 20，000 個碎片 AWS 區域： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/streams/latest/dev/service-sizes-and-limits.html) 對於所有其他區域，預設碎片配額為每個 1，000 或 6，000 個碎片 AWS 帳戶。您可以透過 Service Quotas 主控台檢視您帳戶的碎片配額和使用率，網址為 https：//[https://console.aws.amazon.com/servicequotas/](https://console.aws.amazon.com/servicequotas/)。 若要請求提高碎片配額，請使用 Service Quotas 主控台 或 AWS CLI。如需詳細資訊，請參閱[請求增加配額](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)。  | 
|  資料串流輸送量 | 依預設，使用隨需容量模式建立的新資料串流具有 4 MB/s 的寫入和 8 MB/s 的讀取輸送量。在美國東部 （維吉尼亞北部）、美國西部 （奧勒岡） 和歐洲 （愛爾蘭） AWS 區域，具有隨需容量模式的資料串流可擴展至每秒 10 GB 的寫入和每秒 20 GB 的讀取輸送量。對於其他 區域，具有隨需容量模式的資料串流可擴展至 200 MB/s 的寫入和 400 MB/s 的讀取輸送量。如果您需要為這些區域增加高達 10 GB/s 的寫入和 20 GB/s 的讀取容量，請提交[支援票證](https://support.console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase)。 | 沒有上限。輸送量上限取決於為串流所佈建的碎片數目。每個碎片最多可支援每秒 1 MB 或每秒 1,000 筆記錄的寫入輸送量，或最高每秒 2 MB 或每秒 2,000 筆記錄的讀取輸送量。如果您需要更多擷取容量，您可以使用 AWS 管理主控台 或 [UpdateShardCount](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_UpdateShardCount.html) API 輕鬆擴展串流中的碎片數量。 | 
|  資料承載大小 | 之前記錄的資料承載大小上限為 `base64-encoding` 10 MiB。Kinesis 旨在使用高載容量處理間歇性大型記錄 （大小為 1-10MiB)。 | 
|  `GetRecords` 交易大小 |  [GetRecords](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_GetRecords.html) 每次呼叫可從單一碎片擷取最多 10 MB 的資料，每次呼叫最多 10,000 筆記錄。每呼叫一次 `GetRecords` 即計為一筆讀取交易。每個碎片每秒可支援最多 5 筆讀取交易。每筆讀取交易可提供多達 10,000 筆記錄，每筆交易的配額上限為 10 MiB。 | 
|  每個碎片的資料讀取率 |  每個碎片透過 [GetRecords](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_GetRecords.html) 每秒可支援最多 2 MB 的總資料讀取速率。如果呼叫 `GetRecords` 傳回 10 MB，在接下來的 5 秒內發出的後續呼叫將擲回例外狀況。 | 
|  每個資料串流已註冊的取用者數目 |  使用 Kinesis 隨需優勢模式，您最多可以建立 50 個已註冊的消費者 （增強廣發）。使用 Kinesis 隨需標準和 Kinesis 佈建模式，您可以為每個資料串流建立最多 20 個已註冊消費者 （增強廣發限制）。 | 
|  在佈建和隨需模式之間切換  |  對於您 AWS 帳戶中的每個資料串流，您可以在 24 小時內在隨需和佈建容量模式之間切換兩次。   | 

## API 限制
<a name="kds-api-limits"></a>

如同大多數 AWS APIs，Kinesis Data Streams API 操作會受到速率限制。下列限制適用於每個區域的每個 AWS 帳戶。如需有關 Kinesis Data Streams API 的詳細資訊，請參閱 [Amazon Kinesis API 參考](https://docs.aws.amazon.com/kinesis/latest/APIReference/)。

### KDS 控制平面 API 限制
<a name="kds-api-limits-control"></a>

下列各節將描述 KDS 控制平面 API 的限制。KDS 控制平面 APIs 可讓您建立和管理資料串流。這些限制適用於每個 AWS 區域每個帳戶。


**控制平面 API 限制**  

| API | API 呼叫限制 | 每個帳戶/串流  | Description | 
| --- | --- | --- | --- | 
| AddTagsToStream | 每秒 5 次交易 (TPS) | 每個帳戶 | 每個資料串流 50 個標籤 | 
| CreateStream | 5 TPS | 每個帳戶 | 帳戶中可擁有的串流數目沒有配額上限。當您嘗試執行下列其中一項操作，您會在發出 `CreateStream` 請求時收到 `LimitExceededException`： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/streams/latest/dev/service-sizes-and-limits.html)  | 
| DecreaseStreamRetentionPeriod | 5 TPS | 每個串流 | 資料串流保留期間的最小值為 24 小時。 | 
| DeleteResourcePolicy | 5 TPS | 每個帳戶 | 如果您需要增加此限制，請提出[支援票證](https://support.console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase)。 | 
| DeleteStream | 5 TPS | 每個帳戶 |  | 
| DeregisterStreamConsumer | 5 TPS | 每個串流 |  | 
| DescribeAccountSettings | 5 TPS | 每個帳戶 |  | 
| DescribeLimits | 1 TPS | 每個帳戶 |  | 
| DescribeStream | 10 TPS | 每個帳戶 |  | 
| DescribeStreamConsumer | 20 TPS | 每個串流 |  | 
| DescribeStreamSummary | 20 TPS | 每個帳戶 |  | 
| DisableEnhancedMonitoring | 5 TPS | 每個串流 |  | 
| EnableEnhancedMonitoring | 5 TPS | 每個串流 |  | 
| GetResourcePolicy | 5 TPS | 每個帳戶 | 如果您需要增加此限制，請提出[支援票證](https://support.console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase)。 | 
| IncreaseStreamRetentionPeriod | 5 TPS | 每個串流 | 串流保留期間的最大值為 8760 小時 (365 天)。 | 
| ListShards | 1000 TPS | 每個串流 |  | 
| ListStreamConsumers | 5 TPS | 每個串流 |  | 
| ListStreams | 5 TPS | 每個帳戶 |  | 
| ListTagsForStream | 5 TPS | 每個串流 |  | 
| MergeShards | 5 TPS | 每個串流 | 僅適用於已佈建的項目。 | 
| PutResourcePolicy | 5 TPS | 每個帳戶 | 如果您需要增加此限制，請提出[支援票證](https://support.console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase)。 | 
| RegisterStreamConsumer | 5 TPS | 每個串流 | 您可以對每個資料串流註冊最多 20 個消費者。一個指定消費者一次只能註冊一個資料串流。只能同時建立 5 個消費者。換句話說，您不能同時有超過 5 個處於 CREATING 狀態的取用者。 | 
| RemoveTagsFromStream | 5 TPS | 每個串流 |  | 
| SplitShard | 5 TPS | 每個串流 | 僅適用於已佈建的項目 | 
| StartStreamEncryption |  | 每個串流 | 您可以連續 24 小時成功套用新的 AWS KMS 金鑰進行伺服器端加密 25 次。 | 
| StopStreamEncryption |  | 每個串流 | 在輪換的 24 小時期間，您可以成功停用伺服器端加密 25 次。 | 
| UpdateShardCount |  | 每個串流 | 僅適用於已佈建的項目。碎片數量的預設限制為 10，000。還有此 API 的其他限制。如需詳細資訊，請參閱 [UpdateShardCount](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_UpdateShardCount.html)。 | 
| UpdateStreamMode |  | 每個串流 |  對於您 AWS 帳戶中的每個資料串流，您可以在 24 小時內在隨需和佈建容量模式之間切換兩次。  | 
| UpdateStreamWarmThroughput | 5 TPS | 每個帳戶 | 可設定的暖輸送量上限是帳戶和區域的隨需模式資料串流輸送量限制。 | 
| UpdateAccountSettings | 5 TPS | 每個帳戶 | 啟用或停用帳戶設定，例如隨需優勢模式。 | 

### KDS 資料平面 API 限制
<a name="kds-api-limits-data"></a>

下節描述 KDS 資料平面 API 的限制。KDS 資料平面 API 可讓您使用資料串流來即時收集和處理資料記錄。這些限制適用於資料串流內的每個碎片。


**資料平面 API 限制**  

| API | API 呼叫限制 | 承載限制 | 其他詳細資訊 | 
| --- | --- | --- | --- | 
| GetRecords | 5 TPS | 每個呼叫可傳回的記錄數目上限為 10,000。GetRecords 可傳回的資料大小上限為 10 MB。 | 如果呼叫傳回了此資料數量，在接下來 5 秒內發出的後續呼叫會擲回 ProvisionedThroughputExceededException。如果串流的佈建輸送量不足，在接下來的 1 秒內進行的後續呼叫會擲出 ProvisionedThroughputExceededException。 | 
| GetShardIterator | 5 TPS |  | 分片反覆運算器會在傳回給要求者之後 5 分鐘到期。如果太常發出 GetShardIterator 請求，則會收到 ProvisionedThroughputExceededException。 | 
| PutRecord | 1000 TPS | 每個碎片最多可支援每秒 1，000 筆記錄的寫入，最多可支援每秒 10MiB 的資料寫入總數。 |  Kinesis 旨在使用高載容量處理間歇性大型記錄 （大小為 1-10MiB)。 | 
| PutRecords |  | 每個 PutRecords 請求最高可支援 500 筆記錄。請求中的每個記錄最多可達 10 MiB，整個請求的上限為 10 MiB，包括分割區索引鍵。每個碎片可支援最高每秒 1,000 筆記錄的寫入數目，最高每秒 1 MB 的總計資料寫入上限。 |  Kinesis 旨在使用高載容量處理間歇性大型記錄 （大小為 1-10MiB)。 | 
| SubscribeToShard | 您可以在每個碎片每個註冊消費者每秒對 SubscribeToShard 發出一個呼叫。 |  | 如果您使用相同 ConsumerARN 和 ShardId 在成功呼叫的 5 秒內再次呼叫 SubscribeToShard，將會收到 ResourceInUseException。 | 

## 提高配額
<a name="increasing-kds-limits"></a>

如果配額可調整，您可以使用 Service Quotas 要求增加配額。有些請求會自動解決，有些則提交給 AWS Support。您可以追蹤提交給 AWS Support 的配額增加請求狀態。提高 Service Quotas 的請求不會獲得優先順序支援。如果您有緊急請求，請聯絡 AWS Support。如需詳細資訊，請參閱[什麼是 Service Quotas？](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html)

若要請求增加服務配額，請遵循[請求增加配額](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)中概述的程序。