顔コレクション、顔、ユーザーの管理 - Amazon Rekognition

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

顔コレクション、顔、ユーザーの管理

顔コレクションは、顔とユーザーに関連する情報を含めるために Amazon Rekognition が使用するリソースです。さまざまな Rekognition APIオペレーションを使用して、コレクション自体と、コレクションに保存されている顔または顔ベクトルを管理します。

コレクションの管理

顔コレクションはプライマリ Amazon Rekognition リソースであり、作成する各顔コレクションには一意の Amazon リソースネーム () がありますARN。各顔コレクションは、アカウントの特定の AWS リージョンに作成します。コレクションを作成すると、最新バージョンの顔検出モデルに関連付けられます。詳細については、「モデルバージョニングについて」を参照してください。

コレクションに対しては、以下の管理オペレーションを実行できます。

コレクション内の顔の管理

顔コレクションを作成したら、それに顔を保存できます。Amazon Rekognition では、以下のオペレーションを使用してコレクション内の顔を管理できます。

  • IndexFaces オペレーションは、入力イメージ (JPEG または PNG) 内の顔を検出し、指定された顔コレクションに追加します。イメージで検出された顔ごとに一意の顔 ID が返されます。顔を保存したら、顔コレクション内で一致する顔を検索できます。詳細については、「コレクションへの顔の追加」を参照してください。

  • ListFaces オペレーションは、コレクション内の顔を一覧表示します。詳細については、「コレクションへの顔の追加」を参照してください。

  • DeleteFaces オペレーションはコレクションから顔を削除します。詳細については、「コレクションからの顔の削除」を参照してください。

コレクション内のユーザーの管理

同一人物の複数の顔ベクトルを保存した場合、それらすべての顔ベクトルを 1 つのユーザーベクトルに関連付けることで、精度を高めることができます。次のオペレーションを使用するとユーザーを管理できます。

  • CreateUser - オペレーションは、指定された一意のユーザー ID を使用してコレクションに新しいユーザーを作成します。

  • AssociateUsers - ユーザー ID IDsに 1~100 個の一意の顔を追加します。ユーザーに 1 つ以上の顔 ID をユーザーに関連付けると、コレクショでそのユーザーに一致するものを検索できるようになります。

  • ListUsers - コレクション内のユーザーを一覧表示します。

  • DeleteUsers - 指定されたユーザー ID を持つコレクションからユーザーを削除します。

  • DisassociateFaces - ユーザーIDsから 1 つ以上の顔を削除します。