Amazon Rekognition のガイドラインとクォータ - Amazon Rekognition
サポートされているリージョンクォータの設定デフォルトのクォータ

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

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

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

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

のリストについてはAWSAmazon Rekognition が利用可能なリージョンについては、「」を参照してください。AWS リージョンとエンドポイントのAmazon Web Services 全般リファレンス。

クォータの設定

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

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

Amazon Rekognition Image

  • Amazon S3 オブジェクトとして保存できるイメージのサイズは 15 MB までに制限されています。

  • 高さと幅の最小画像サイズはどちらも 80 ピクセルです。の最小イメージ寸法DetectProtectiveEquipmentは、高さと幅のどちらも 64 ピクセルです。

  • の画像の最大サイズDetectProtectiveEquipmentは、幅と高さの両方で 4096 ピクセルです。

  • によって検出されるDetectProtectiveEquipmentでは、800x1300 のイメージでは、人は 100x100 ピクセル以下でなければなりません。サイズが 800 x 1300 ピクセルを超える場合は、比例してより大きめの最小サイズが必要です。

  • 1920x1080 ピクセルのイメージでは、顔が 40x40 ピクセル以上でないと検出できません。寸法が 1920X1080 ピクセルよりも大きいイメージでは、必要な最小顔サイズも比例してより大きくなります。

  • API にパラメータとして渡すイメージの最大サイズ (raw バイト) は 5 MB です。制限は 4 MBDetectProtectiveEquipmentアピ。

  • Amazon Rekognition は、PNG および JPEG イメージ形式をサポートしています。さまざまな API オペレーション (DetectLabels や IndexFaces など) に入力として渡すイメージは、サポートされている形式であることが必要です。

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

  • 検索 API から返される一致する顔の最大数は 4096 です。

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

  • DetectProtectiveEquipment15人までの個人用保護具を検出できます。

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

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 は、ACC オーディオコーデックのみをサポートします。

  • ページ分割トークンの有効期限 (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サービスクォータ。これらの制限はデフォルトで、変更できます。制限の引き上げをリクエストするには、ケースを作成します。現在のクォータ制限 (適用されたクォータ値) を確認するには、を参照してください。Amazon Rekognition Service Quotas。の TPS 使用率履歴を表示するにはAmazon Rekognition Image API「」を参照してください。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 オペレーションおよびリージョンは影響を受けません。