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

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

Kinesis Data Streams のクォータと制限

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

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

  • デフォルトのシャードクォータはAWSアカウントで、次のAWSリージョン: 現在、これらの機能は、米国東部 (オレゴン)、欧州 (アイルランド) です。そのほかのすべてのリージョンでは、デフォルトのシャードクォータはAWSアカウント.

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

  • 1 つのシャードは 1 秒あたり最大 1 MB のデータを取り込むことができ (パーティションキーを含む)、書き込みについては 1 秒あたり 1,000 レコードを取り込むことができます。同様に、ストリームを 5,000 シャードにスケールする場合、ストリームは 1 秒あたり最大 5 GB または 500 万レコードを取り込むことができます。取り込み容量を増やす必要がある場合は、AWS Management Console または UpdateShardCount API を使用して、ストリーム内のシャード数を簡単にスケールアップできます。

  • 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 の制限

ほとんどのようなAWSAPI では、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 あなたは正常に新しいAWS24 時間周期で 25 回、サーバー側の暗号化を行う 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 が発生します。

クォータの引き上げ

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

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