Amazon Rekognition のガイドラインとクォータ - Amazon Rekognition

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

Amazon Rekognition のガイドラインとクォータ

以下のセクションでは、Amazon Rekognition を使用する際のガイドラインとクォータについて説明します。クォータは 2 種類あります。[クォータの設定] たとえば、イメージの最大サイズを変更することはできません。[デフォルトのクォータ] にリストされている AWS Service Quotas ページを変更するには、デフォルトのクォータ セクションで説明されている手順に従います。

サポートされるリージョン

Amazon Rekognition が利用可能な AWS リージョンのリストについては、アマゾン ウェブ サービス全般のリファレンス「AWS リージョンとエンドポイント」を参照してください。

クォータの設定

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

Amazon Rekognition カスタムラベルの制限については、「Amazon Rekognition カスタムラベルのガイドラインとクォータ」を参照してください。

Amazon Rekognition イメージ

  • 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 オペレーション (DetectLabelsIndexFaces など) に入力として渡すイメージは、サポートされている形式であることが必要です。

  • 1 つの顔コレクションに保存できる顔ベクトルの最大数は 2,000 万です。

  • 1 つの顔コレクションに保存できる顔ベクトルの、デフォルトの最大数は 1,000 万です。

  • 検索 API から返される、一致する顔ベクトルの最大数は 4,096 です。

  • 検索 API から返される、一致するユーザーベクトルの最大数は 4,096 です。

  • DetectText はイメージから最大 100 個の単語を検出できます。

  • DetectProtectiveEquipment は、15 人までの個人用保護具を検出できます。

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

Amazon Rekognition イメージ一括分析

  • Amazon Rekognition Image Bulk Analysis では、最大 10,000 個のイメージバッチを分析できます。

  • Amazon Rekognition Image Bulk Analysis は、最大 50MB の入力マニフェストをサポートします。

Amazon Rekognition Video 保存ビデオ

  • 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 時間です。ページ分割トークンは、GetLabeldetection など、Get オペレーションで返される NextToken フィールド内にあります。

Amazon Rekognition Video ストリーミング ビデオ

  • Kinesis ビデオ入力ストリームは、最大 1 つの Amazon Rekognition Video ストリームプロセッサと関連付けることができます。

  • Kinesis ビデオ入力ストリームは、最大 1 つの Amazon Rekognition Video ストリームプロセッサと関連付けることができます。

  • Amazon Rekognition Video ストリームプロセッサに関連付けられた Kinesis ビデオ入力ストリームや Kinesis データ出力ストリームを複数のプロセッサで共有することはできません。

  • オーディオデータを分析する Amazon Rekognition Video API は、ACC オーディオコーデックのみをサポートします。

デフォルトのクォータ

デフォルトのクォータのリストについては、「AWS Service Quotas」を参照してください。このデフォルトの制限は変更できます。制限の引き上げをリクエストするには、ケースを作成してください。現在のクォータ制限 (適用されたクォータ値) を確認するには、[Amazon Rekognition Service Quotas]を参照してください。Amazon Rekognition Image API の TPS 使用率履歴を表示するには「Amazon Rekognition Service Quotas ページ」を参照し、特定の API オペレーションを選択して、その操作の履歴を表示します。

TPS クォータの変更を計算する

お客様が要求している新しい制限は何ですか? 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 クォータのベストプラクティス

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

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

  2. 再試行を設定します。エラー処理 のガイドラインをフォローして、エラーの再試行を構成します。

  3. エクスポネンシャルバックオフとジッターの設定 リトライを設定するときにエクスポネンシャルバックオフとジッタを設定すると、達成可能なスループットを向上させることができます。「」の「エラーの再試行とエクスポネンシャルバックオフ AWS」を参照してください。

TPS クォータを変更するケースを作成する

ケースを作成するには、「ケースの作成」を参照し、以下の質問に答えます。

  • TPS クォータのベストプラクティス トラフィックのスパイクをスムーズにし、再試行、エクスポネンシャルバックオフ、ジッタを設定するために実装しましたか?

  • 必要な TPS クォータの変更を計算しましたか? そうでない場合は、「TPS クォータの変更を計算する」を参照してください。

  • TPS の使用履歴を確認して、将来のニーズをより正確に予測しましたか? TPS の使用履歴を表示するには、Amazon Rekognition Service Quotas ページ を参照ください。

  • ユースケースは何ですか。

  • どの API を使用しますか。

  • これらの API を使用するリージョンはどれですか。

  • 負荷を複数のリージョンに分散させることはできますか?

  • 毎日何枚の画像を処理していますか。

  • このボリュームを維持する期間はどれくらいですか (1 回限りのスパイクですか、それとも進行中ですか)。

  • デフォルトの制限でどのようにブロックされていますか。次の例外表を参照して、発生したシナリオを確認します。

    エラーコード Exception メッセージ これはどういう意味ですか。 再試行できますか。
    HTTP ステータスコード 400

    ProvisionedThroughputExceededException

    プロビジョンドレートを超過しました

    スロットリングを示します。制限の引き上げリクエストを再実行または評価できます。

    はい

    HTTP ステータスコード 400

    ThrottlingException

    レートを下げてください: リクエストのレートが急激に増加しました。

    スパイキートラフィックを送信し、スロットリングに遭遇している可能性があります。トラフィックを形作って、よりスムーズで一貫性のあるものにする必要があります。次に、追加の再試行を設定します。ベストプラクティスを共有します。 はい
    HTTP ステータスコード 5xx ThrottlingException (HTTP 500) Service Unavailable

    バックエンドがアクションをサポートするためにスケールアップ中であることを示します。リクエストを再実行する必要があります。

    はい

    エラーコードの詳細については、「エラー処理」を参照してください。

注記

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