

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

# Amazon Rekognition のガイドラインとクォータ
<a name="limits"></a>

以下のセクションでは、Amazon Rekognition を使用する際のガイドラインとクォータについて説明します。クォータは 2 種類あります。[*クォータの設定*] たとえば、イメージの最大サイズを変更することはできません。[*デフォルトのクォータ*] にリストされている [AWS Service Quotas](https://docs.aws.amazon.com/general/latest/gr/rekognition.html#limits_rekognition) ページを変更するには、[デフォルトのクォータ](#changeable-quotas) セクションで説明されている手順に従います。

**Topics**
+ [サポートされているリージョン](#supported-regions)
+ [クォータの設定](#quotas)
+ [デフォルトのクォータ](#changeable-quotas)

## サポートされているリージョン
<a name="supported-regions"></a>

AWS Amazon Rekognition が利用可能な リージョンの一覧については「[AWS リージョンとエンドポイント](https://docs.aws.amazon.com/general/latest/gr/rekognition.html) 」を「*Amazon Web Services 全般のリファレンス* 」でご覧ください。

## クォータの設定
<a name="quotas"></a>

以下は、変更できない Amazon Rekognition の制限の一覧です。トランザクション/秒 (TPS) などサービスの制限 に関する情報については、「[デフォルトのクォータ](#changeable-quotas)」を参照してください。

Amazon Rekognition カスタムラベルの制限については、「[Amazon Rekognition カスタムラベルのガイドラインとクォータ](https://docs.aws.amazon.com/rekognition/latest/customlabels-dg/limits.html)」を参照してください。

### Amazon Rekognition イメージ
<a name="limits-image"></a>
+ Amazon S3 オブジェクトとして保存できるイメージの最大サイズは 15 MB に制限されています。
+ `DetectModerationLabels` に利用できる高さと幅の最大イメージサイズはどちらも 10K ピクセルです。
+ `DetectLabels` に利用できる高さと幅の最大イメージサイズはどちらも 10K ピクセルです。
+ 1920x1080 ピクセルのイメージでは、顔が 40x40 ピクセル以上でないと検出できません。寸法が 1920X1080 ピクセルよりも大きいイメージでは、必要な最小顔サイズも比例してより大きくなります。
+ 高さと幅の最小画像サイズはどちらも 80 ピクセルです。`DetectProtectiveEquipment` に利用できる高さと幅の最小画像サイズはどちらも 64 ピクセルです。
+ `DetectProtectiveEquipment` に利用できる高さと幅の最大画像サイズはどちらも 4,096 ピクセルです。
+ 800x1300 ピクセルのイメージでは、顔が 100x100 ピクセル以上でないと `DetectProtectiveEquipment` 検出できません。寸法が 800x1300 ピクセルよりも大きいイメージでは、必要な最小顔サイズも比例してより大きくなります。
+ API にパラメータとして渡すイメージの最大サイズ (raw バイト) は 5 MB です。制限は 4 MB `DetectProtectiveEquipment` API。
+ Amazon Rekognition は、PNG および JPEG イメージ形式をサポートしています。さまざまな API オペレーション (`DetectLabels` や `IndexFaces` など) に入力として渡すイメージは、サポートされている形式であることが必要です。
+ 1 つの顔コレクションに保存できる顔ベクトルの最大数は 2,000 万です。
+ 1 つの顔コレクションに保存できる顔ベクトルの、デフォルトの最大数は 1,000 万です。
+ 検索 API から返される、一致する顔ベクトルの最大数は 4,096 です。
+ 検索 API から返される、一致するユーザーベクトルの最大数は 4,096 です。
+ `DetectText` はイメージから最大 100 個の単語を検出できます。
+ `DetectProtectiveEquipment` は、15 人までの個人用保護具を検出できます。

イメージと顔の比較に関するベストプラクティスについては、「[センサー、入力イメージ、ビデオのベストプラクティス](best-practices.md)」を参照してください。

### Amazon Rekognition Image 一括分析
<a name="limits-image"></a>
+ Amazon Rekognition Image 一括分析では、最大 10,000 個の画像を一括で分析できます。
+ Amazon Rekognition Image 一括分析では、最大 50 MB の入力マニフェストをサポートしています。

### Amazon Rekognition Video 保存ビデオ
<a name="limits-vstored-video"></a>
+ Amazon Rekognition Video では、サイズが 10 GB までの保存済みビデオを分析できます。
+ Amazon Rekognition Video では、長さが 6 時間までの保存済みビデオを分析できます。
+ Amazon Rekognition Video は、アカウントあたり最大 20 の同時ジョブをサポートしています。
+ 保存されたビデオは、H.264 コーデックを使用してエンコードする必要があります。サポートされているファイル形式は MPEG-4 および MOV です。
+ オーディオデータを分析する Amazon Rekognition Video API は、AAC オーディオコーデックのみをサポートします。
+ ページ分割トークンの有効期限 (TTL) は 24 時間です。ページ分割トークンは、`NextToken` など、Get オペレーションで返される `GetLabeldetection` フィールド内にあります。

### Amazon Rekognition Video ストリーミング ビデオ
<a name="limits-streaming-video"></a>
+ Kinesis ビデオ入力ストリームは、最大 1 つの Amazon Rekognition Video ストリームプロセッサと関連付けることができます。
+ Kinesis ビデオ入力ストリームは、最大 1 つの Amazon Rekognition Video ストリームプロセッサと関連付けることができます。
+ Amazon Rekognition Video ストリームプロセッサに関連付けられた Kinesis ビデオ入力ストリームや Kinesis データ出力ストリームを複数のプロセッサで共有することはできません。
+ オーディオデータを分析する Amazon Rekognition Video API は、ACC オーディオコーデックのみをサポートします。

## デフォルトのクォータ
<a name="changeable-quotas"></a>

デフォルトのクォータのリストについては、「[AWS Service Quotas](https://docs.aws.amazon.com/general/latest/gr/rekognition.html#limits_rekognition)」を参照してください。このデフォルトの制限は変更できます。制限の引き上げをリクエストするには、ケースを作成してください。現在のクォータ制限 (適用されたクォータ値) を確認するには、[[Amazon Rekognition Service Quotas](https://us-west-2.console.aws.amazon.com/servicequotas/home/services/rekognition/quotas)］を参照してください。[Amazon Rekognition Image API](https://docs.aws.amazon.com/rekognition/latest/dg/API_Reference.html) の TPS 使用率履歴を表示するには「[Amazon Rekognition Service Quotas ページ](https://us-west-2.console.aws.amazon.com/servicequotas/home/services/rekognition/quotas)」を参照し、特定の API オペレーションを選択して、その操作の履歴を表示します。

**Topics**
+ [TPS クォータの変更を計算する](#quotas-calculating)
+ [TPS クォータのベストプラクティス](#quotas-best-practices)
+ [TPS クォータを変更するケースを作成する](#quotas-create-case)

### TPS クォータの変更を計算する
<a name="quotas-calculating"></a>

お客様が要求している新しい制限は何ですか？ 1 秒あたりのトランザクション数 (TPS) は、予想されるワークロードのピーク時に最も関連性があります。ワークロードのピーク時およびレスポンスの時間 (5 ～ 15 秒) の最大同時 API 呼び出しを理解することが重要です。最小が 5 秒のためご注意ください。以下に 2 つの例を挙げます。
+ 例 1: 最も忙しい時間の開始時に予想される最大同時顔認証 (CompareFaces API) ユーザー数は 1000 です。これらの応答は 10 秒間にわたって広がります。したがって、関連するリージョンの CompareFaces API に必要なTPS は 100 (1000/10) です。
+ 例 2: 最も忙しい時間の初めに予想される最大同時オブジェクト検出 (DetectLabels API) 呼び出しは 250 です。これらの応答は 5 秒間にわたって広がります。したがって、関連するリージョンの DetectLabels API に必要な TPS は 50 (250/5) です。

### TPS クォータのベストプラクティス
<a name="quotas-best-practices"></a>

Transactions Per Second (TPS) の推奨されるベストプラクティスには、スパイキートラフィックのスムーズ化、再試行の設定、エクスポネンシャルバックオフとジッタの設定などがあります。

1. スパイキートラフィックのスムーズ化。スパイキートラフィックはスループットに影響します。割り当てられたトランザクション/秒 (TPS) の最大スループットを得るには、キューイングサーバーレスアーキテクチャまたは別のメカニズムを使用してトラフィックを「スムーズ」し、一貫性を保ちます。Rekognition を使用したサーバーレス大規模イメージおよびビデオ処理のコードサンプルおよびリファレンスについては、[Amazon Rekognition による大規模な画像や動画処理](https://github.com/aws-samples/amazon-rekognition-serverless-large-scale-image-and-video-processing) を参照ください。

1. 再試行を設定します。[エラー処理](error-handling.md) のガイドラインをフォローして、エラーの再試行を構成します。

1. エクスポネンシャルバックオフとジッターの設定 リトライを設定するときにエクスポネンシャルバックオフとジッタを設定すると、達成可能なスループットを向上させることができます。[[AWS のエラー再試行とエクスポネンシャルバックオフ](https://docs.aws.amazon.com/general/latest/gr/api-retries.html)] を参照ください

### TPS クォータを変更するケースを作成する
<a name="quotas-create-case"></a>

ケースを作成するには、「[ケースの作成](https://console.aws.amazon.com/support/v1#/case/create?issueType=service-limit-increase)」を参照し、以下の質問に答えます。
+ [TPS クォータのベストプラクティス](#quotas-best-practices) トラフィックのスパイクをスムーズにし、再試行、エクスポネンシャルバックオフ、ジッタを設定するために実装しましたか？ 
+ 必要な TPS クォータの変更を計算しましたか？ そうでない場合は、「[TPS クォータの変更を計算する](#quotas-calculating)」を参照してください。
+ TPS の使用履歴を確認して、将来のニーズをより正確に予測しましたか？ TPS の使用履歴を表示するには、[Amazon Rekognition Service Quotas ページ](https://us-west-2.console.aws.amazon.com/servicequotas/home/services/rekognition/quotas) を参照ください。
+ ユースケースは何ですか。
+ どの API を使用しますか。
+ これらの API を使用するリージョンはどれですか。
+ 負荷を複数のリージョンに分散させることはできますか？
+ 毎日何枚の画像を処理していますか。
+ このボリュームを維持する期間はどれくらいですか (1 回限りのスパイクですか、それとも進行中ですか)。
+ デフォルトの制限でどのようにブロックされていますか。次の例外表を参照して、発生したシナリオを確認します。    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/limits.html)

  エラーコードの詳細については、「[エラー処理](error-handling.md)」を参照してください。

**注記**  
これらの制限は、お住まいの地域によって異なります。制限を変更するケースは、リクエストしたリージョンで、リクエストした API オペレーションに影響します。その他の API オペレーションおよびリージョンは影響を受けません。