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

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

重要

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

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

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

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

API	アカウント制限: リクエスト	アカウント制限: ストリーム	ストリームレベルの制限	関連する例外とメモ
CreateStream	50 TPS [秒〕	サポートされているすべてのリージョンで、アカウント [s] ごとに 10,000 ストリーム。 注記 この制限は、アカウントあたり 100,000 ストリーム（またはそれ以上）まで増やすことができます。 AWS Management Console で にサインインhttps://console.aws.amazon.com/し、この制限の引き上げをリクエストします。		デバイス、CLIs、 駆動SDK型アクセス、コンソールはすべて、この を呼び出すことができますAPI。ストリームがまだ存在しない場合、1 つのAPI呼び出しのみが成功します。
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]	プレイリストあたりのフラグメントの最大数: 5,000 [h]
G etHLSMasterプレイリスト	5 TPS [h]	該当なし
G etHLSMediaプレイリスト	5 TPS [h]	プレイリストあたりのフラグメントの最大数: 5,000 [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があると仮定します。GetClip API は両方のテーブルに表示されます。

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

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 秒の持続時間フラグメント、オーディオトラックとビデオトラックHLS、5 にMaxMediaPlaylistFragmentResults設定されたライブストリーミングシナリオでは、メディアプレイヤーは通常、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 秒	値は標準である 100 ns 単位で指定されますSDK。
最大クラスター期間	30 秒	値は標準である 100 ns 単位で指定されますSDK。バックエンド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クラスターのフレームタイムスタンプを表す最小タイムコードスケール値。値は標準である 100 ns 単位で指定されますSDK。
タイムコードスケール値の最大の長さ	1 秒	結果のMKVクラスターのフレームタイムスタンプを表す最大タイムコードスケール値。値は標準である 100 ns 単位で指定されますSDK。
コンテンツビュー項目の最小数	10
最小のバッファ時間	20 秒	値は標準である 100 ns 単位で指定されますSDK。
アップデートバージョンの最大の長さ	128 文字
最大ARN長	1024 文字
フラグメントシーケンスの最大の長さ	128 文字
最大保持期間	10 年