Amazon Kinesis Video Streams サービスクォータ

Kinesis Video Streams には、次のサービスクォータがあります。

重要

次のサービスクォータは、サポートチケットを送信してアップグレードできるソフト [s] または引き上げることができないハード [h] のいずれかです。以下の表では、個々のサービスクォータの横に [s] と [h] が表示されます。

コントロールプレーンAPIサービスクォータ

次のセクションでは、コントロールプレーン のサービスクォータについて説明しますAPIs。TPS は 1 秒あたりのトランザクション数を表します。

アカウントレベルまたはリソースレベルのリクエスト制限に達すると、 ClientLimitExceededExceptionがスローされます。

コントロールプレーンAPIサービスクォータ

API	アカウント制限: リクエスト	アカウント制限: ストリーム	ストリームレベルの制限	関連する例外と注意事項
CreateStream	50 TPS [s]	米国東部 (バージニア北部) および米国西部 (オレゴン) リージョンでは、アカウント [s] あたり 10,000 ストリーム。他のすべてのサポートされているリージョンでは、アカウント [s] あたり 5,000 ストリーム。 注記 この制限は、アカウントあたり 100,000 ストリーム（またはそれ以上）まで増やすことができます。https://console.aws.amazon.com/ で AWS Management Console にサインインし、Kinesis Video Streams のサービス制限の引き上げケースを送信し、この制限の引き上げをリクエストします。		デバイス、CLIs、 駆動SDK型アクセス、コンソールはすべてこの を呼び出すことができますAPI。ストリームが存在しない場合、成功するAPI呼び出しは 1 つだけです。
DeleteEdgeConfiguration	10 TPS [h]	該当なし	1 TPS [h]
DeleteStream	50 TPS [h]	該当なし	5 TPS [h]
DescribeEdgeConfiguration	50 TPS [h]	該当なし	5 TPS [h]
DescribeImageGenerationConfiguration	50 TPS [h]	該当なし	5 TPS [h]
DescribeMappedResourceConfiguration	50 TPS [h]	該当なし	5 TPS [h]
DescribeNotificationConfiguration	50 TPS [h]	該当なし	5 TPS [h]
DescribeStream	300 TPS [h]	該当なし	5 TPS [h]
GetDataEndpoint	300 TPS [h]	該当なし	5 TPS [h]	ほとんどの PutMedia/GetMedia ユースケースでは、ストリーミングトークンを更新するために 45 分ごとに呼び出されます。データエンドポイントのキャッシュは、アプリケーションで失敗時に再ロードされる場合、安全です。
ListEdgeAgentConfigurations	50 TPS [h]	該当なし	該当なし
ListStreams	50 TPS [h]	該当なし
ListTagsForStream	50 TPS [h]	該当なし	5 TPS [h]
StartEdgeConfigurationUpdate	10 TPS [h]	該当なし	1 TPS [h]
TagStream	50 TPS [h]	該当なし	5 TPS [h]
UntagStream	50 TPS [h]	該当なし	5 TPS [h]
UpdateDataRetention	50 TPS [h]	該当なし	5 TPS [h]
UpdateImageGenerationConfiguration	50 TPS [h]	該当なし	5 TPS [h]
UpdateNotificationConfiguration	50 TPS [h]	該当なし	5 TPS [h]
UpdateStream	50 TPS [h]	該当なし	5 TPS [h]

メディアとアーカイブメディアAPIのサービスクォータ

次のセクションでは、メディア およびアーカイブされたメディア のサービスクォータについて説明しますAPIs。

アカウントレベルまたはリソースレベルのリクエスト制限に達すると、 ClientLimitExceededExceptionがスローされます。

接続レベルのリクエスト制限に到達すると、ConnectionLimitExceededException がスローされます。

次のエラーまたは ACK は、フラグメントレベルの制限に達したときにスローされます。

• MIN_FRAGMENT_DURATION_REACHED ACK は、最小期間より小さいフラグメントに対して返されます。

• MAX_FRAGMENT_DURATION_REACHED ACK は、最大期間より大きいフラグメントに対して返されます。

• MAX_FRAGMENT_SIZE ACK は、最大データサイズより大きいフラグメントに対して返されます。

• GetMediaForFragmentList オペレーションでフラグメントの制限に達した場合、FragmentLimitExceeded の例外がスローされます。

データプレーンAPIサービスクォータ

API	ストリームレベルの制限	接続レベルの制限	帯域幅制限	フラグメントレベルの制限	関連する例外と注意事項
PutMedia	5 TPS [h]	1 [s]	ストリームあたり 12.5 MB/秒、または 100 Mbps [s]	最小フラグメント継続時間: 1 秒 [h] 最大フラグメント継続時間: 20 秒 [h] 最大フラグメントサイズ: 50 MB [h] トラックの最大数: 3 [s] 1 秒あたりに送信されるフラグメントの最大数: 5 [h] フラグメントメタデータの最大制限: 10 タグ [h]	一般的なPutMediaリクエストには数秒間のデータが含まれているため、ストリームTPSあたりのデータが少なくなります。クォータを超える同時接続が複数ある場合、最後の接続が受け入れられます。
GetClip	該当なし	該当なし	100 MB のサイズ制限 [h]	フラグメントの最大数: 200 [h]
G etDASHStreamingセッションURL	25 TPS [h]	該当なし	該当なし	該当なし
G etHLSStreamingセッションURL	25 TPS [h]	該当なし	該当なし	該当なし
GetImages	該当なし	該当なし	100 MB [h]	該当なし	リクエストあたりのイメージの最大数は 100 [h] です。 注記 の最小値SamplingIntervalは 200 ミリ秒 (ms) で、1 秒あたり 5 イメージです。
GetMedia	5 TPS [h]	3 [s]	25 MB/秒または 200 Mbps [s]	1 秒あたり最大 5 個のフラグメントを送信 [h]	一意の消費側クライアントは、接続が確立された後、アプリケーションが継続的に読み取る必要があるTPSため、2 つまたは 3 つを超える必要はありません。 一般的なフラグメントが約 5 MB の場合、この制限は Kinesis ビデオストリームMBpsあたり約 75 を意味します。このようなストリームは、ストリームの最大受信ビットレートの 2 倍の送信ビットレートを持ちます。 注記 GetMedia は HLS/DASH 再生には使用されません。
GetMediaForFragmentList	該当なし	5 [s]	25 MB/秒または 200 Mbps [s]	フラグメントの最大数: 1000 [h]	5 つのフラグメントベースの消費アプリケーションが同時に を呼び出すことができますGetMediaForFragmentList。それ以上の接続は拒否されます。

動画再生プロトコルAPIサービスクォータ

API	セッションレベルの制限	フラグメントレベルの制限
G etDASHManifestプレイリスト	5 TPS [h]	プレイリストあたりの最大フラグメント数: 5000 [h]
G etHLSMasterプレイリスト	5 TPS [h]	該当なし
G etHLSMediaプレイリスト	5 TPS [h]	プレイリストあたりの最大フラグメント数: 5000 [h]
取得MP4InitFragment	5 TPS [h]	該当なし
取得MP4MediaFragment	20 TPS [h]	該当なし
GetTSFragment	20 TPS [h]	該当なし

フラグメントメタデータクォータとフラグメントメディアクォータ

APIs アーカイブされたメディアにアクセスするための Kinesis Video Streams は、API呼び出しの数ではなく、リクエストされたフラグメントの数に基づいてスロットリングされます。APIs は、フラグメントメタデータの数とリクエストされたフラグメントメディアの数の両方によってレート制限されます。フラグメントメタデータクォータとフラグメントメディアクォータは、ストリームごとに適用されます。つまり、あるストリーム内のフラグメントメタデータまたはフラグメントメディアのリクエストは、別のストリームのクォータには適用されません。ただし、特定のストリーム内では、各クォータは複数の 間で共有されますAPIs。つまり、特定のストリームでは、異なる にわたるフラグメントのリクエストが同じクォータからAPIs消費されます。ストリームのフラグメントメタデータまたはフラグメントメディアクォータのいずれかを超えると、 は APIを返しますClientLimitExceededException。次の表は、 が 2 種類のクォータのそれぞれからAPIsどのように消費するかを示しています。これらのテーブルの 2 番目の列では、ストリームのクォータが N の場合、 はそのストリームのクォータタイプから消費する N ポイントAPIsがあると仮定します。は両方のテーブルGetClipAPIに表示されます。

フラグメントメタデータクォータの消費

API	リクエストごとに消費されるクォータポイントの数	共有クォータ (N)
ListFragments	MaxResults パラメータの値	ストリームあたり 1 秒あたり 10,000 クォータポイント [h]
GetClip	作成されるクリップ内のフラグメントの数
GetHLSMediaPlaylist	MaxMediaPlaylistFragmentResults パラメータの値
GetDASHManifest	MaxManifestFragmentResults パラメータの値
GetImages	値 400 + リクエストされたイメージの最大数

フラグメントメディアクォータの消費

API	リクエストごとに消費されるクォータポイントの数	共有クォータ (N)
GetMediaForFragmentList	Fragments パラメータのフラグメントの数	ストリームあたり 1 秒あたり 500 クォータポイント [h]
GetClip	作成されるクリップ内のフラグメントの数
GetMP4MediaFragment	1
GetTSFragment	1
GetImages	リクエストされたイメージの最大数

例えば、1 秒あたり 500 フラグメントメディアのクォータの場合、特定のストリームについて次のような呼び出しパターンがサポートされています。

• 各クリップに 100 個のフラグメントの GetClip に 1 秒あたり 5 個のリクエスト。

• 各クリップに 5 個のフラグメントの GetClip に 1 秒あたり 100 個のリクエスト。

• 各クリップに 100 個のフラグメントの GetClip に 1 秒あたり 2 個のリクエスト、および、各クリップの GetMediaForFragmentList に 1 秒あたり 3 個のリクエスト。

• GetMP4MediaFragment に 1 秒あたり 400 個のリクエスト、および GetTSFragment に 1 秒あたり 100 個のリクエスト。

これらのクォータは、ストリームごとにサポートできる HLSおよび MPEG-DASH セッションの数に関して重要な意味を持ちます。メディアプレーヤーが一度に使用できる HLSおよび DASHセッションの数に制限はありません。したがって、再生アプリケーションでは、同時に使用できるセッションが多すぎないことが重要です。次の 2 つの例は、サポートできる同時再生セッションの数を決定する方法を示しています。

例 1: ライブストリーミング

1 秒の再生時間フラグメント、オーディオトラック、ビデオトラック、 を 5 MaxMediaPlaylistFragmentResultsに設定HLSしてライブストリーミングシナリオでは、メディアプレーヤーは通常、1 秒GetHLSMediaPlaylistあたり 2 回の呼び出しを行います。1 つの呼び出しは最新のビデオメタデータ用で、もう 1 つの呼び出しは対応するオーディオメタデータ用です。2 つの呼び出しは、それぞれ 5 つのフラグメントメタデータクォータポイントを消費します。また、1 秒GetMP4MediaFragmentあたり 2 回の呼び出しを行います。1 回の呼び出しは最新のビデオ用、もう 1 回の呼び出しは対応する音声用です。各呼び出しは 1 つのフラグメントメディアトークンを消費するため、合計 2 つのトークンが消費されます。

このシナリオでは、最大 250 の同時再生セッションをサポートできます。250 セッションの場合、このシナリオでは、1 秒あたり 2,500 のフラグメントメタデータクォータポイント (10,000 クォータを大幅に下回る) および 1 秒あたり 500 のフラグメントメディアクォータポイントが消費されます。

例 2: オンデマンド再生

オーディオトラックとビデオトラックで MPEGDASHを 1,000 MaxManifestFragmentResultsに設定する過去のイベントのオンデマンド再生シナリオでは、メディアプレーヤーは通常、セッションの開始時に 1 GetDASHManifest回 (フラグメントメタデータクォータポイントを 1,000 回消費) 呼び出し、すべてのフラグメントがロードされるまで 1 秒あたり最大 5 回 (フラグメントメディアクォータポイントを 5 回消費) のレートGetMP4MediaFragmentで呼び出します。このシナリオでは、1 秒あたり最大 10 個の新しいセッションを開始でき (ちょうど 1 秒あたり 10,000 のフラグメントメタデータクォータ)、最大 100 セッションでフラグメントメディアを 1 秒あたり 5 のレートでアクティブにロードできます (ちょうど 1 秒あたり 500 のフラグメントメディアクォータ)。

フラグメントメタデータポイント、およびフラグメントメディアクォータポイントの消費量をモニタリングするには、ArchivedFragmentsConsumed.Metadata と ArchivedFragmentsConsumed.Media をそれぞれ使用します。モニタリングの詳細については、「Amazon Kinesis Video Streams のモニタリング」を参照してください。

ストリーミングメタデータサービスクォータ

Kinesis ビデオストリームへのストリーミングメタデータの追加には、次のサービスクォータが適用されます。

• フラグメントの先頭には 10 個までメタデータ項目を追加できます。

• フラグメントのメタデータの名前の長さは、最大 128 バイトです。

• フラグメントのメタデータの値の長さは、最大 256 バイトです。

• フラグメントメタデータ名は文字列AWS「」で始めることはできません。このようなメタデータ項目が追加されると、 の putFragmentMetadataメソッドはSTATUS_INVALID_METADATA_NAMEエラー (エラーコード 0x52000077) PICを返します。その後、アプリケーションはエラーを無視するか ( PICはメタデータ項目を追加しません）、エラーに応答できます。

プロデューサーSDKのクォータ

次の表に、 の値の現在のクォータを示しますSDK。詳細については、「Kinesis Video Streams へのアップロード」を参照してください。

注記

これらの値を設定する前に、入力値を検証する必要があります。SDK はこれらの制限を検証せず、制限を超えた場合はランタイムエラーが発生します。

値	制限	メモ
最大ストリームカウント	128	プロデューサーオブジェクトが作成できるストリームの最大数です。これはソフト制限です (増加をリクエストできます)。これにより、プロデューサーが誤って再帰的にストリームを作成しなくなります。
デバイス名の最大の長さ	128 文字
最大タグカウント	ストリームあたり 50
ストリーム名の最大の長さ	256 文字
最小ストレージサイズ	10 MiB = 10 ｘ 1024 ｘ 1024 バイト
最大ストレージサイズ	10 GiB = 10 ｘ 1024 ｘ 1024 ｘ 1024 バイト
最大のルートディレクトリの長さ	4,096 文字
最大の auth info の長さ	10,000 バイト
最大URI文字列長	10,000 文字
タグ名の最大の長さ	128 文字
タグ値の最大の長さ	1,024 文字
最小のセキュリティトークン期間	30 秒
セキュリティトークン猶予期間	40 分	指定された期間が長い場合は、この値に制限されます。
保持期間	0 または 1 時間以上	0 は保持なしを示します。
最小クラスター期間	1 秒	値は、SDK標準である 100 ns 単位で指定されます。
最大クラスター期間	30 秒	値は、SDK標準である 100 ns 単位で指定されます。バックエンドAPIでは、クラスター期間を短くすることができます。
ラグメントの最大サイズ	50 MB	詳細については、「Amazon Kinesis Video Streams サービスクォータ」を参照してください。
最大フラグメント期間	20 秒	詳細については、「Amazon Kinesis Video Streams サービスクォータ」を参照してください。
最大接続時間	45 分	この時間後にバックエンドは接続を終了します。はトークンをSDKローテーションし、この時間内に新しい接続を確立します。
最大ACKセグメント長	1,024 文字	ACK パーサー関数に送信される確認応答の最大セグメント長。
コンテンツタイプ文字列の最大の長さ	128 文字
コーデック ID 文字列の最大の長さ	32 文字
トラック名文字列の最大の長さ	32 文字
コーデックプライベートデータの最大の長さ	1 MiB = 1 ｘ 1024 ｘ 1024 バイト
タイムコードスケール値の最小の長さ	100 ns	結果のMKVクラスターのフレームタイムスタンプを表す最小タイムコードスケール値。値は、SDK標準である 100 ns 単位で指定されます。
タイムコードスケール値の最大の長さ	1 秒	結果のMKVクラスターのフレームタイムスタンプを表す最大タイムコードスケール値。値は、SDK標準である 100 ns 単位で指定されます。
コンテンツビュー項目の最小数	10
最小のバッファ時間	20 秒	値は、SDK標準である 100 ns 単位で指定されます。
アップデートバージョンの最大の長さ	128 文字
最大ARN長	1024 文字
フラグメントシーケンスの最大の長さ	128 文字
最大保持期間	10 年