翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Rekognition のアクション、リソース、および条件キー
Amazon Rekognition (サービスプレフィックス: rekognition) では、IAM アクセス許可ポリシーで使用できるように、以下のサービス固有のリソースやアクション、条件コンテキストキーが用意されています。
参照:
-
このサービスを設定する方法について説明します。
-
このサービスで使用可能な API オペレーションのリストを表示します。
-
IAM アクセス許可ポリシーを使用して、このサービスとそのリソースを保護する方法を学びます。
Amazon Rekognition で定義されるアクション
IAM ポリシーステートメントの Action エレメントでは、以下のアクションを指定できます。ポリシーを使用して、 AWSでオペレーションを実行するアクセス許可を付与します。ポリシーでアクションを使用する場合は、通常、同じ名前の API オペレーションまたは CLI コマンドへのアクセスを許可または拒否します。ただし、場合によっては、1 つのアクションによって複数のオペレーションへのアクセスが制御されます。あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。
[アクション] テーブルの [リソースタイプ] 列は、各アクションがリソースレベルの許可をサポートしているかどうかを示します。この列に値がない場合は、ポリシーステートメントの Resource 要素で、ポリシーが適用されるすべてのリソース (「*」) を指定する必要があります。列にリソースタイプが含まれる場合、そのアクションを含むステートメントでそのタイプの ARN を指定できます。アクションで 1 つ以上のリソースが必須となっている場合、呼び出し元には、それらのリソースを伴うアクションを使用するための許可が付与されている必要があります。必須リソースは、アスタリスク (*) でテーブルに示されています。IAM ポリシーの Resource 要素でリソースアクセスを制限する場合は、必要なリソースタイプごとに ARN またはパターンを含める必要があります。一部のアクションでは、複数のリソースタイプがサポートされています。リソースタイプがオプション (必須として示されていない) の場合、オプションのリソースタイプのいずれかを使用することを選択できます。
[アクション] テーブルの [条件キー] 列には、ポリシーステートメントの Condition 要素で指定できるキーが含まれます。サービスのリソースに関連付けられている条件キーの詳細については、[リソースタイプ] テーブルの [条件キー] 列を参照してください。
注記
リソース条件キーは、リソースタイプテーブルに一覧表示されています。アクションに適用されるリソースタイプへのリンクは、[アクション] テーブルの [リソースタイプ (* 必須)] 列にあります。[リソースタイプ] テーブルのリソースタイプには、[アクション] テーブルのアクションに適用されるリソース条件キーである、[条件キー] 列が含まれています。
以下の表の列の詳細については、「アクションテーブル」を参照してください。
| アクション | 説明 | アクセスレベル | リソースタイプ (* 必須) | 条件キー | 依存アクション |
|---|---|---|---|---|---|
| AssociateFaces | 1 人のユーザーに複数の顔を個別の関連付ける許可を付与 | 書き込み | |||
| CompareFaces | ソース入力イメージ内の顔とターゲット入力イメージ内で検出された各顔を比較する許可を付与します。 | 読み取り | |||
| CopyProjectVersion | 既存のモデルバージョンを新しいモデルバージョンにコピーする許可を付与 | 書き込み | |||
| CreateCollection | でコレクションを作成するアクセス許可を付与します AWS リージョン | 書き込み | |||
| CreateDataset | 新しい Amazon Rekognition Custom Labels データセットを作成するためのアクセス許可を付与します。 | 書き込み | |||
| CreateFaceLivenessSession | Face Liveness セッションを作成する許可を付与 | 書き込み | |||
| CreateProject | Amazon Rekognition Custom Labels プロジェクトを作成するためのアクセス許可を付与します。 | 書き込み | |||
| CreateProjectVersion | モデルの新しいバージョントレーニングを開始するアクセス許可を付与します。 | 書き込み | |||
| CreateStreamProcessor | Amazon Rekognition ストリームプロセッサを作成するアクセス許可を付与します。 | 書き込み | |||
| CreateUser | 提供した一意のユーザー ID を使用して、コレクション内に新しいユーザー作成する許可を付与 | 書き込み | |||
| DeleteCollection | 指定されたコレクションを削除するためのアクセス許可を付与します。 | 書き込み | |||
| DeleteDataset | 既存の Amazon Rekognition Custom Labels データセットを削除するアクセス許可を付与します。 | 書き込み | |||
| DeleteFaces | コレクションから顔を削除する許可を付与します。 | 書き込み | |||
| DeleteProject | プロジェクトを削除する許可を付与 | 書き込み | |||
| DeleteProjectPolicy | プロジェクトにアタッチされたリソースポリシーを削除する許可を付与 | 書き込み | |||
| DeleteProjectVersion | モデルを削除する許可を付与 | 書き込み | |||
| DeleteStreamProcessor | 指定された ストリープロセッサーを削除する許可を付与します。 | 書き込み | |||
| DeleteUser | 提供されたユーザー ID に基づいて、コレクションからユーザーを削除する許可を付与 | 書き込み | |||
| DescribeCollection | コレクションに関する詳細を読み取るためのアクセス許可を付与します。 | 読み込み | |||
| DescribeDataset | Amazon Rekognition Custom Labels データセットを記述するアクセス許可を付与します。 | 読み込み | |||
| DescribeProjectVersions | Amazon Rekognition Custom Labels プロジェクトでモデルのバージョンを一覧表示するアクセス許可を付与します。 | 読み込み | |||
| DescribeProjects | Amazon Rekognition Custom Labels プロジェクトを一覧表示するアクセス許可を付与します。 | 読み込み | |||
| DescribeStreamProcessor | 指定されたストリームプロセッサーに関する情報を取得する許可を付与します。 | 読み込み | |||
| DetectCustomLabels | 提供された画像内のカスタムラベルを検出する権限を付与します。 | 読み込み | |||
| DetectFaces | 入力として提供されるイメージ内の人間の顔を検出するアクセス許可を付与します。 | 読み込み | |||
| DetectLabels | 入力として提供されるイメージ内の実社会ラベルのインスタンスを検出する許可を付与します。 | 読み込み | |||
| DetectModerationLabels | 入力画像内のモデレーションラベルを検出する権限を付与します。 | 読み込み | |||
| DetectProtectiveEquipment | 入力画像内の個人用保護具を検出するアクセス許可を付与します。 | 読み込み | |||
| DetectText | 入力イメージ内のテキストを検出し、コンピュータが読み取り可能なテキストに変換する許可を付与します。 | 読み取り | |||
| DisassociateFaces | ユーザー ID と顔 ID の関連付けを削除する許可を付与 | 書き込み | |||
| DistributeDatasetEntries | トレーニングデータセット内のエントリを、プロジェクトのトレーニングデータセットおよびテストデータセット全体に分散する権限を付与します。 | 書き込み | |||
| GetCelebrityInfo | 有名人の名前と追加情報を読む権限を付与します。 | 読み込み | |||
| GetCelebrityRecognition | 非同期有名人認識ジョブによって保存されたビデオで見つかった有名人認識の結果を読み取る権限を付与します。 | 読み込み | |||
| GetContentModeration | 非同期コンテンツモデレーションジョブによって保存された動画で見つかったコンテンツモデレーション分析結果を読み取る権限を付与します。 | 読み込み | |||
| GetFaceDetection | 非同期顔検出ジョブによって保存されたビデオで見つかった顔検出結果を読み取る権限を付与します。 | 読み取り | |||
| GetFaceLivenessSessionResults | Face Liveness セッションの結果を取得する許可を付与 | 読み取り | |||
| GetFaceSearch | 非同期顔検索ジョブによって保存されたビデオで見つかった一致するコレクション顔を読み取る権限を付与します。 | 読み込み | |||
| GetLabelDetection | 非同期ラベル検出ジョブによって保存されたビデオで見つかったラベル検出結果を読み取る権限を付与します。 | 読み取り | |||
| GetMediaAnalysisJob | S3 内のジョブ結果への参照とメディア分析ジョブに関する追加情報を読み取るアクセス許可を付与します。 | 読み取り | |||
| GetPersonTracking | 非同期の人物追跡ジョブによって保存されたビデオで検出された人物のリストを読み取る権限を付与します。 | 読み込み | |||
| GetSegmentDetection | 非同期セグメント検出ジョブによって、保存されたビデオで見つかったビデオセグメントを取得する権限を付与します。 | 読み込み | |||
| GetTextDetection | 非同期テキスト検出ジョブによって保存されたビデオで見つかったテキストを取得する権限を付与します。 | 読み込み | |||
| IndexFaces | 入力イメージで検出された顔で既存のコレクションを更新するアクセス許可を付与します。 | 書き込み | |||
| ListCollections | アカウント内のコレクション ID を読み取る権限を付与します。 | 読み込み | |||
| ListDatasetEntries | 既存の Amazon Rekognition Custom Labels データセット内のデータセットエントリを一覧表示する権限を付与します。 | 読み込み | |||
| ListDatasetLabels | データセットのラベルを一覧表示する権限を付与します。 | 読み込み | |||
| ListFaces | 指定したコレクション内の顔のメタデータを読み込むアクセス許可を付与します。 | 読み取り | |||
| ListMediaAnalysisJobs | メディア分析ジョブのリストを読み取るアクセス許可を付与します。 | 読み取り | |||
| ListProjectPolicies | プロジェクトにアタッチされたリソースポリシーを一覧表示する許可を付与 | 読み取り | |||
| ListStreamProcessors | ストリームプロセッサのリストを取得するアクセス許可を付与します。 | リスト | |||
| ListTagsForResource | リソースに関連付けられたタグのリストを返す許可を付与します。 | 読み取り | |||
| ListUsers | UserIds と を一覧表示するアクセス許可を付与します UserStatus | 読み取り | |||
| PutProjectPolicy | リソースポリシーをプロジェクトにアタッチする許可を付与 | 書き込み | |||
| RecognizeCelebrities | 入力画像内の有名人を検出するアクセス許可を付与します。 | 読み込み | |||
| SearchFaces | 提供された顔IDに、指定されたコレクションを検索する権限を付与します。 | 読み込み | |||
| SearchFacesByImage | 入力画像内の最大の顔の特定されたコレクションを検索するアクセス許可を付与します。 | 読み取り | |||
| SearchUsers | 指定されたコレクション内で、特定の顔 ID またはユーザー ID に一致するユーザーを検索する許可を付与 | 読み取り | |||
| SearchUsersByImage | 入力画像内の最大の顔を使用して、指定されたコレクションで一致するユーザーを検索する許可を付与 | 読み取り | |||
| StartCelebrityRecognition | 保存した動画内の有名人の非同期認識を開始する許可を付与します。 | 書き込み | |||
| StartContentModeration | 保存した動画の明示的もしくは暗示的なアダルトコンテンツの非同期検出を開始する許可を付与します。 | 書き込み | |||
| StartFaceDetection | 保存したビデオの顔の非同期検出を開始するアクセス許可を付与します。 | 書き込み | |||
| StartFaceLivenessSession | Face Liveness のセッションの動画ストリーミングを開始する許可を付与 | 書き込み | |||
| StartFaceSearch | 保存した動画で検出された人物の顔に一致するコレクションの顔の非同期検索を開始する許可を付与します。 | 書き込み | |||
| StartLabelDetection | 保存した動画内のラベルの非同期検出を開始するアクセス許可を付与します。 | 書き込み | |||
| StartMediaAnalysisJob | メディア分析ジョブを開始するアクセス許可を付与します。 | 書き込み | |||
| StartPersonTracking | 保存した動画内の人の非同期トラッキングを開始する許可を付与します。 | 書き込み | |||
| StartProjectVersion | モデルのバージョンを実行する許可を付与します。 | 書き込み | |||
| StartSegmentDetection | 保存したビデオのセグメントの非同期検出を開始するアクセス許可を付与します。 | 書き込み | |||
| StartStreamProcessor | ストリームプロセッサの実行を開始するアクセス許可を付与します。 | 書き込み | |||
| StartTextDetection | 保存したビデオのテキストの非同期検出を開始するアクセス許可を付与します。 | 書き込み | |||
| StopProjectVersion | モデルのバージョンの実行を停止する許可を付与します。 | 書き込み | |||
| StopStreamProcessor | 実行中のストリームプロセッサを停止するアクセス許可を付与します。 | 書き込み | |||
| TagResource | リソースに 1 つ以上のタグを追加する許可を付与 | タグ付け | |||
| UntagResource | リソースから 1 つ以上のタグを削除する許可を付与 | タグ付け | |||
| UpdateDatasetEntries | データセット内の 1 つ以上の JSON 行 (エントリ) を追加または更新する権限を付与します。 | 書き込み | |||
| UpdateStreamProcessor | ストリームプロセッサのプロパティを修正する許可の付与 | 書き込み |
Amazon Rekognition で定義されるリソースタイプ
以下のリソースタイプは、このサービスによって定義され、IAM アクセス許可ポリシーステートメントの Resource エレメントで使用できます。アクションテーブルの各アクションは、そのアクションで指定できるリソースタイプを示しています。リソースタイプは、ポリシーに含めることができる条件キーを定義することもできます。これらのキーは、[リソースタイプ] テーブルの最後の列に表示されます。以下の表の列の詳細については、「リソースタイプテーブル」を参照してください。
| リソースタイプ | ARN | 条件キー |
|---|---|---|
| collection |
arn:${Partition}:rekognition:${Region}:${Account}:collection/${CollectionId}
|
|
| streamprocessor |
arn:${Partition}:rekognition:${Region}:${Account}:streamprocessor/${StreamprocessorId}
|
|
| project |
arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/${CreationTimestamp}
|
|
| projectversion |
arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/version/${VersionName}/${CreationTimestamp}
|
|
| dataset |
arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/dataset/${DatasetType}/${CreationTimestamp}
|
Amazon Rekognition の条件キー
Amazon Rekognition では、IAM ポリシーの Condition 要素で使用できる以下の条件キーを定義します。これらのキーを使用して、ポリシーステートメントが適用される条件をさらに絞り込むことができます。以下の表の列の詳細については、「条件キーテーブル」を参照してください。
すべてのサービスで使用できるグローバル条件キーを確認するには、「使用できるグローバル条件キー」を参照してください。
| 条件キー | 説明 | [Type] (タイプ) |
|---|---|---|
| aws:RequestTag/${TagKey} | リクエストで渡されたタグによりアクセスをフィルタリングします | 文字列 |
| aws:ResourceTag/${TagKey} | リソースに関連付けられたタグによりアクセスをフィルタリングします | 文字列 |
| aws:TagKeys | リクエストで渡されたタグキーによりアクセスをフィルタリングします | ArrayOfString |
