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

# Amazon Kinesis Video Streams サービスクォータ
<a name="limits"></a>

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

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

## コントロールプレーン API サービスクォータ
<a name="limits-akv-control"></a>

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

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


| API | アカウント制限: リクエスト | アカウント制限: ストリーム | ストリームレベルの制限 | 関連する例外と注意事項 | 
| --- | --- | --- | --- | --- | 
| CreateStream | 50 TPS [s] | サポートされているすべてのリージョンで、アカウント [s] あたり 10,000 ストリーム。 この制限は、アカウントあたり 100,000 ストリーム（またはそれ以上）まで増やすことができます。 AWS マネジメントコンソール で にサインイン[https://console.aws.amazon.com/](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] |  | 
| UpdateStreamStorageConfiguration | 50 TPS [h] | 該当なし | 5 TPS [h] |  | 
| DescribeStreamStorageConfiguration | 50 TPS [h] | 該当なし | 5 TPS [h] |  | 

## メディアおよびアーカイブメディア API サービスクォータ
<a name="limits-akv-data"></a>

次のセクションでは、メディア 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 [h] | ストリームあたり 12.5 MB/秒、または 100 Mbps [s] | [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/kinesisvideostreams/latest/dg/limits.html) | [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html) リクエストはストリーミングで長時間実行される接続です。1 つの永続接続で複数のフラグメントを送信できるため、データごとに新しい接続を開く必要はありません。複数の同時PutMedia接続を試みると、Kinesis Video Streams は最新の接続をConnectionLimitExceededExceptionエラーメッセージでスロットリングします。 | 
| GetClip | 該当なし | 該当なし | 100 MB のサイズ制限 [h] | フラグメントの最大数: 200 [h] |  | 
| GetDASHStreamingSessionURL | 25 TPS [h] | 該当なし | 該当なし | 該当なし |  | 
| GetHLSStreamingSessionURL | 25 TPS [h] | 該当なし | 該当なし | 該当なし |  | 
| GetImages | 該当なし | 該当なし | 100 MB [h]  | 該当なし | リクエストあたりのイメージの最大数は 100 [h] です。 の最小値`SamplingInterval`は 200 ミリ秒 (ms) で、1 秒あたり 5 イメージです。  | 
| GetMedia | 5 TPS [h] | 3 [h] | 25 MB/秒または 200 Mbps [s] | 1 秒あたり最大 5 個のフラグメントを送信 [h] | [GetMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_GetMedia.html) リクエストはストリーミングで長時間実行される接続です。1 つの永続接続で複数のフラグメントを送信できるため、データごとに新しい接続を開く必要はありません。3 つ以上の同時GetMedia接続を試みると、Kinesis Video Streams は最新の接続をConnectionLimitExceededExceptionエラーメッセージでスロットリングします。一般的なフラグメントが約 5 MB の場合、この制限は Kinesis ビデオストリームあたり約 75 MBps を意味します。このようなストリームは、ストリームの最大受信ビットレートの 2 倍の送信ビットレートを持ちます。 `GetMedia` は HLS/DASH 再生には使用されません。  | 
| 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] | 該当なし | 

## フラグメントメタデータクォータとフラグメントメディアクォータ
<a name="fragment_based_throttling"></a>

Kinesis Video Streams の[アーカイブされたメディアにアクセスするための API](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_Reference.html) は、API コールの回数ではなく、リクエストされたフラグメントの数に基づいてスロットリングされます。APIs は、フラグメントメタデータの数とリクエストされたフラグメントメディアの数の両方によってレート制限されます。フラグメントメタデータクォータとフラグメントメディアクォータは、ストリームごとに適用されます。つまり、あるストリーム内のフラグメントメタデータまたはフラグメントメディアのリクエストは、別のストリームのクォータには適用されません。ただし、特定のストリーム内では、各クォータは複数の API 間で共有されます。これは、特定のストリームでは、異なる API にまたがるフラグメントに対するリクエストは、同じクォータから消費されるからです。ストリームのフラグメントメタデータまたはフラグメントメディアクォータが制限を超えると、API は `ClientLimitExceededException` を返します。次の表は、2 種類のクォータのそれぞれについて、API がどのように消費するかを示しています。表の 2 番目の列では、あるストリームが N 個のクォータを持つと仮定します。すなわち、API は、そのストリームのそのクォータタイプから消費する N 個のポイントを持ちます。`GetClip` API は両方のテーブルに表示されます。

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


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


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


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


例えば、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 のモニタリング](monitoring.md)」を参照してください。

## ストリーミングメタデータサービスクォータ
<a name="limits-streaming-metadata"></a>

Kinesis ビデオストリームへのストリーミングメタデータの追加には、次のサービスクォータが適用されます。
+ フラグメントの先頭には 10 個までメタデータ項目を追加できます。
+ フラグメントのメタデータの*名前*の長さは、最大 128 バイトです。
+ フラグメントのメタデータの*値*の長さは、最大 256 バイトです。
+ フラグメントメタデータ*名*は文字列`AWS`「」で始めることはできません。そのようなメタデータ項目が追加された場合は、PIC の `putFragmentMetadata` メソッドは `STATUS_INVALID_METADATA_NAME` エラー (エラーコード: `0x52000077`) を返します。アプリケーションは、エラーを無視する (PIC はメタデータ項目を追加しません) か、エラーに対応します。

## プロデューサー SDK クォータ
<a name="producer-sdk-limits"></a>

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

**注記**  
これらの値を設定する前に、入力値を検証する必要があります。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 は、より短いクラスター期間を適用できます。 | 
| ラグメントの最大サイズ | 50MB | 詳細については、「[Amazon Kinesis Video Streams サービスクォータ](#limits)」を参照してください。 | 
| 最大フラグメント期間 | 20 秒 | 詳細については、「[Amazon Kinesis Video Streams サービスクォータ](#limits)」を参照してください。 | 
| 最大接続時間 | 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 年 |   |