Kinesis Data Streams のクォータと制限 - Amazon Kinesis Data Streams

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Kinesis Data Streams のクォータと制限

Amazon Kinesis Data Streams には、次のストリームクォータとシャードクォータと制限があります。

  • アカウントに存在できるストリームの数にクォータ上限はありません。

  • デフォルトのシャードクォータは、AWS アカウントあたり 500 シャードです。米国東部 (バージニア北部)、米国西部 (オレゴン)、欧州 (アイルランド) です。そのほかのすべてのリージョンでは、デフォルトのシャードクォータは AWS アカウントあたり 200 シャードです。

    データストリームあたりのシャードのクォータ引き上げをリクエストするには、「クォータ引き上げのリクエスト」で説明されている手順に従います。

  • 1 つのシャードは 1 秒あたり最大 1 MB のデータを取り込むことができ (パーティションキーを含む)、書き込みについては 1 秒あたり 1,000 レコードを取り込むことができます。同様に、ストリームを 5,000 シャードにスケールする場合、ストリームは 1 秒あたり最大 5 GB または 500 万レコードを取り込むことができます。取り込み容量を増やす必要がある場合は、AWS マネジメントコンソールまたはUpdateShardCountAPI.

  • Base64 エンコーディング前のレコードのデータペイロードのサイズは、最大 1 MB です。

  • GetRecords では、1 つのシャードから最大 10 MB のデータを取得でき、呼び出しごとに最大 10,000 レコードを取得できます。GetRecords への各呼び出しは、1 つの読み込みトランザクションとしてカウントされます。

  • 各シャードは 1 秒あたり最大 5 件のトランザクションをサポートできます。各読み込みトランザクションは最大 10,000 レコードを提供でき、トランザクションあたり 10 MB のクォータ上限があります。

  • 各シャードは、GetRecords を介して最大 2 MB/秒の合計データ読み取りレートをサポートします。GetRecords への呼び出しで 10 MB が返される場合、次の 5 秒以内に行われたそれ以降の呼び出しでは、例外がスローされます。

API の制限

ほとんどの AWS API と同様に、Kinesis Data Streams API オペレーションにはレート制限があります。リージョンごと、AWS アカウントごとに以下の制限が適用されます。Kinesis Data Streams API の詳細については、『』を参照してください。Amazon Kinesis API リファレンス

KDS コントロールプレーン API の制限

次のセクションでは、KDS コントロールプレーン API の制限を示します。KDS コントロールプレーン API を使用すると、データストリームを作成および管理できます。これらの制限は、リージョンごと、AWS アカウントごとに適用されます。

コントロールプレーン API の制限
API API コールの制限 ストリームレベルの制限 その他の詳細
AddTagsToStream 1 秒あたり 5 件のトランザクション (TPS) リージョン、アカウント、データストリームあたり 50 タグ
CreateStream 5 TPS アカウントに存在できるストリームの数にクォータ上限はありません。 CreateStream リクエストを作成するときに、以下のいずれかを実行しようとすると、LimitExceededException が発生します。
  • 特定の時点で、5 つを超える CREATING 状態のストリームを持つ。

  • アカウントに許可されている数よりも多くのシャードを作成する。

DecreaseStreamRetentionPeriod 5 TPS データストリームの保持期間の最小値は 24 時間です。
DeleteStream 5 TPS 該当なし
DeregisterStreamConsumer 5 TPS 該当なし
DescribeLimits 1 TPS
DescribeStream 10 TPS 該当なし
DescribeStreamConsumer 20 TPS 該当なし
DescribeStreamSummary 20 TPS 該当なし
DisableEnhancedMonitoring 5 TPS 該当なし
EnableEnhancedMonitoring 5 TPS 該当なし
IncreaseStreamRetentionPeriod 5 TPS ストリームの保持期間の最大値は 8760 時間 (365 日) です。
ListShards 100 TPS 該当なし
ListStreamConsumers 5 TPS 該当なし
ListStreams 5 TPS 該当なし
ListTagsForStream 5 TPS 該当なし
MergeShards 5 TPS 該当なし
RegisterStreamConsumer 5 TPS コンシューマーはデータストリームごとに最大 20 登録できます。指定されたコンシューマーは、一度に 1 つのデータストリームに登録できます。同時に作成できるコンシューマーは 5 つだけです。つまり、同時に 5 つを超える CREATING ステータスのコンシューマーを持つことはできません。CREATING ステータスのコンシューマーが 5 つあるときに 6 番目のコンシューマーを登録すると、LimitExceededException が発生します。
RemoveTagsFromStream 5 TPS 該当なし
SplitShard 5 TPS 該当なし
StartStreamEncryption 24 時間周期で 25 回、新しい AWS KMS キーをサーバー側の暗号化に正常に適用できます。
StopStreamEncryption 24 時間のローリング期間あたり、サーバー側の暗号化を 25 回無効にすることができます。
UpdateShardCount
  • ストリームごとに、24 時間のローリング期間あたり 10 倍以上スケールする

  • ストリームの現在のシャード数を 2 倍以上にスケールアップする

  • ストリームの現在のシャード数の半分以下にスケールダウンする

  • ストリームで 10000 を超えるシャードにスケールアップする

  • 結果が 10000 未満でない限り、10000 を超えるシャードを持つストリームをスケールする

  • アカウントのシャード制限を超えてスケールアップする

KDS データプレーンの API の制限

次のセクションでは、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 秒あたり 1,000 レコードまでの書き込みをサポートし、1 秒あたり 1 MB の最大データ書き込みをサポートします。
PutRecords 各 PutRecords リクエストは、最大 500 レコードをサポートできます。リクエストに含まれる各レコードは 1 MB、リクエスト全体の上限はパーティションキーを含めて最大 5 MB。各シャードは、1 秒あたり 1,000 レコードまでの書き込みをサポートし、1 秒あたり 1 MB の最大データ書き込みをサポートします。
SubscribeToShard シャードごと、登録済みコンシューマーごとに 1 秒あたり SubscribeToShard を 1 回呼び出すことができます。 呼び出しが成功してから 5 秒以内に同じ ConsumerARN と ShardId で SubscribeToShard を再度呼び出すと、ResourceInUseException が発生します。

クォータの引き上げ

クォータが調整可能な場合は、サービスクォータを使用してクォータの引き上げを要求できます。一部のリクエストは自動的に解決され、その他のリクエストは AWS サポートに送信されます。AWS サポートに送信されたクォータ引き上げリクエストのステータスを追跡できます。サービスクォータを引き上げるリクエストは、優先サポートを受けません。緊急のリクエストがある場合は、AWS サポートにお問い合わせください。詳細については、「What Is Service Quotas?」を参照してください。

サービスクォータの引き上げをリクエストするには、「Requesting a Quota Increase」で説明している手順に従います。