翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Kinesis Video Streams には、次のサービスクォータがあります。
重要
以下のサービスクォータは、サポートチケットを送信してアップグレードできるソフト [s] か、引き上げることができないハード [h] のいずれかです。以下の表では、個々のサービスクォータの横に [s] と [h] が表示されます。
コントロールプレーン API サービスクォータ
次のセクションでは、コントロールプレーン APIs のサービスクォータについて説明します。TPS はTransactions Per Second (1 秒あたりのトランザクション数) の略です。
アカウントレベルまたはリソースレベルのリクエスト制限に達すると、 ClientLimitExceededExceptionがスローされます。
| API | アカウント制限: リクエスト | アカウント制限: ストリーム | ストリームレベルの制限 | 関連する例外と注意事項 |
|---|---|---|---|---|
| CreateStream | 50 TPS [s] | サポートされているすべてのリージョンで、アカウント [s] あたり 10,000 ストリーム。注記この制限は、アカウントあたり 100,000 ストリーム（またはそれ以上）まで増やすことができます。 AWS Management Console で にサインインhttps://console.aws.amazon.com/ |
デバイス、CLI、SDK 駆動型のアクセス、およびコンソールは、すべてこの API を呼び出します。ストリームが既に存在しない場合、1 つの API コールのみが成功します。 | |
| DeleteEdgeConfiguration | 10 TPS [h] | 該当なし | 10 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] | 該当なし | 10 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 サービスクォータ
次のセクションでは、メディア API とアーカイブメディア APIs のサービスクォータについて説明します。
アカウントレベルまたはリソースレベルのリクエスト制限に達すると、 ClientLimitExceededExceptionがスローされます。
接続レベルのリクエスト制限に到達すると、ConnectionLimitExceededException がスローされます。
次のエラーまたは ACK は、フラグメントレベルの制限に達したときにスローされます。
-
MIN_FRAGMENT_DURATION_REACHEDACK は、最小期間より小さいフラグメントに対して返されます。 -
MAX_FRAGMENT_DURATION_REACHEDACK は、最大期間より大きいフラグメントに対して返されます。 -
MAX_FRAGMENT_SIZEACK は、最大データサイズより大きいフラグメントに対して返されます。 -
GetMediaForFragmentListオペレーションでフラグメントの制限に達した場合、FragmentLimitExceededの例外がスローされます。
データプレーン API サービスクォータ
| API | ストリームレベルの制限 | 接続レベルの制限 | 帯域幅制限 | フラグメントレベルの制限 | 関連する例外と注意事項 |
|---|---|---|---|---|---|
| PutMedia | 5 TPS [h] | 1 [s] | ストリームあたり 12.5 MB/秒、または 100 Mbps [s] |
|
一般的な PutMedia リクエストには数秒のデータが含まれ、ストリームあたりの TPS は減ります。クォータを超える同時接続が複数ある場合、最後の接続が受け入れられます。 |
| GetClip | 該当なし | 該当なし | 100 MB のサイズ制限 [h] | フラグメントの最大数: 200 [h] | |
| GetDASHStreamingSessionURL | 25 TPS [h] | 該当なし | 該当なし | 該当なし | |
| GetHLSStreamingSessionURL | 25 TPS [h] | 該当なし | 該当なし | 該当なし | |
| GetImages | 該当なし | 該当なし | 100 MB [h] | 該当なし | リクエストあたりのイメージの最大数は 100 [h] です。 注記の最小値 |
| GetMedia | 5 TPS [h] | 3 [s] | 25 MB/秒または 200 Mbps [s] | 1 秒あたり最大 5 個のフラグメントを送信 [h] | 一意の消費クライアントは、接続が確立された後、アプリケーションが継続的に読み取る必要があるため、3 つまたは 3 つを超える TPS を必要としません。 一般的なフラグメントが約 5 MB の場合、この制限は Kinesis ビデオストリームあたり最大 75 MBps を意味します。このようなストリームは、ストリームの最大受信ビットレートの 2 倍の送信ビットレートを持ちます。 注記
|
| GetMediaForFragmentList | 該当なし | 5 [s] | 25 MB/秒または 200 Mbps [s] | フラグメントの最大数: 1000 [h] | 5 つのフラグメントベースの消費アプリケーションが同時に を呼び出すことができますGetMediaForFragmentList。それ以上の接続は拒否されます。 |
動画再生プロトコル API サービスクォータ
| API | セッションレベルの制限 | フラグメントレベルの制限 |
|---|---|---|
| GetDASHManifestPlaylist | 5 TPS [h] | プレイリストあたりのフラグメントの最大数: 5,000 [h] |
| GetHLSMasterPlaylist | 5 TPS [h] | 該当なし |
| GetHLSMediaPlaylist | 5 TPS [h] | プレイリストあたりのフラグメントの最大数: 5,000 [h] |
| GetMP4InitFragment | 5 TPS [h] | 該当なし |
| GetMP4MediaFragment | 20 TPS [h] | 該当なし |
| GetTSFragment | 20 TPS [h] | 該当なし |
フラグメントメタデータクォータとフラグメントメディアクォータ
Kinesis Video Streams のアーカイブされたメディアにアクセスするための API は、API コールの回数ではなく、リクエストされたフラグメントの数に基づいてスロットリングされます。APIs は、フラグメントメタデータの数とリクエストされたフラグメントメディアの数の両方によってレート制限されます。フラグメントメタデータクォータとフラグメントメディアクォータは、ストリームごとに適用されます。つまり、あるストリーム内のフラグメントメタデータまたはフラグメントメディアのリクエストは、別のストリームのクォータには適用されません。ただし、特定のストリーム内では、各クォータは複数の API 間で共有されます。これは、特定のストリームでは、異なる API にまたがるフラグメントに対するリクエストは、同じクォータから消費されるからです。ストリームのフラグメントメタデータまたはフラグメントメディアクォータが制限を超えると、API は ClientLimitExceededException を返します。次の表は、2 種類のクォータのそれぞれについて、API がどのように消費するかを示しています。表の 2 番目の列では、あるストリームが N 個のクォータを持つと仮定します。すなわち、API は、そのストリームのそのクォータタイプから消費する N 個のポイントを持ちます。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 秒の再生時間フラグメント、オーディオトラックとビデオトラック、 を 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: オンデマンド再生
音声と動画のトラックがあり、MaxManifestFragmentResults は 1000 に設定し、MPEG-DASH を使用した過去のイベントをオンデマンド再生するシナリオでは、メディアプレイヤーは通常 GetDASHManifest をセッションの開始時に 1 回呼び出し (フラグメントメタデータクォータポイントを 1,000 消費)、GetMP4MediaFragment をすべてのフラグメントがロードされるまで 1 秒あたり最大 5 回の割合で呼び出します (フラグメントメディアクォータポイントを 5 消費)。このシナリオでは、1 秒あたり最大 10 個の新しいセッションを開始でき (ちょうど 1 秒あたり 10,000 のフラグメントメタデータクォータ)、最大 100 セッションでフラグメントメディアを 1 秒あたり 5 のレートでアクティブにロードできます (ちょうど 1 秒あたり 500 のフラグメントメディアクォータ)。
フラグメントメタデータポイント、およびフラグメントメディアクォータポイントの消費量をモニタリングするには、ArchivedFragmentsConsumed.Metadata と ArchivedFragmentsConsumed.Media をそれぞれ使用します。モニタリングの詳細については、「Amazon Kinesis Video Streams のモニタリング」を参照してください。
ストリーミングメタデータサービスクォータ
Kinesis ビデオストリームへのストリーミングメタデータの追加には、次のサービスクォータが適用されます。
-
フラグメントの先頭には 10 個までメタデータ項目を追加できます。
-
フラグメントのメタデータの名前の長さは、最大 128 バイトです。
-
フラグメントのメタデータの値の長さは、最大 256 バイトです。
-
フラグメントメタデータ名は文字列
AWS「」で始めることはできません。そのようなメタデータ項目が追加された場合は、PIC のputFragmentMetadataメソッドはSTATUS_INVALID_METADATA_NAMEエラー (エラーコード:0x52000077) を返します。アプリケーションは、エラーを無視する (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 年 |
