Amazon Elastic Container Registry のアクション、リソース、および条件キー

Amazon Elastic Container Registry (サービスプレフィックス: ecr) では、IAM アクセス許可ポリシーで使用できるように、以下のサービス固有のリソースやアクション、条件コンテキストキーが用意されています。

参照:

このサービスを設定する方法について説明します。
このサービスで使用可能な API オペレーションのリストを表示します。
IAM アクセス許可ポリシーを使用して、このサービスとそのリソースを保護する方法を学びます。

トピック

Amazon Elastic Container Registry で定義されるアクション
Amazon Elastic Container Registry で定義されるリソースタイプ
Amazon Elastic Container Registry の条件キー

Amazon Elastic Container Registry で定義されるアクション

IAM ポリシーステートメントの Action エレメントでは、以下のアクションを指定できます。ポリシーを使用して、AWS でオペレーションを実行するアクセス許可を付与します。ポリシーでアクションを使用する場合は、通常、同じ名前の API オペレーションまたは CLI コマンドへのアクセスを許可または拒否します。ただし、場合によっては、1 つのアクションによって複数のオペレーションへのアクセスが制御されます。あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

[アクション] テーブルの [リソースタイプ] 列は、各アクションがリソースレベルの許可をサポートしているかどうかを示します。この列に値がない場合は、ポリシーステートメントの Resource 要素で、ポリシーが適用されるすべてのリソース (「*」) を指定する必要があります。列にリソースタイプが含まれる場合、そのアクションを含むステートメントでそのタイプの ARN を指定できます。アクションで 1 つ以上のリソースが必須となっている場合、呼び出し元には、それらのリソースを伴うアクションを使用するための許可が付与されている必要があります。必須リソースは、アスタリスク (*) でテーブルに示されています。IAM ポリシーの Resource 要素でリソースアクセスを制限する場合は、必要なリソースタイプごとに ARN またはパターンを含める必要があります。一部のアクションでは、複数のリソースタイプがサポートされています。リソースタイプがオプション (必須として示されていない) の場合、オプションのリソースタイプのいずれかを使用することを選択できます。

[アクション] テーブルの [条件キー] 列には、ポリシーステートメントの Condition 要素で指定できるキーが含まれます。サービスのリソースに関連付けられている条件キーの詳細については、[リソースタイプ] テーブルの [条件キー] 列を参照してください。

注記

リソース条件キーは、リソースタイプテーブルに一覧表示されています。アクションに適用されるリソースタイプへのリンクは、[アクション] テーブルの [リソースタイプ (* 必須)] 列にあります。[リソースタイプ] テーブルのリソースタイプには、[アクション] テーブルのアクションに適用されるリソース条件キーである、[条件キー] 列が含まれています。

以下の表の列の詳細については、「アクションテーブル」を参照してください。

アクション	説明	アクセスレベル	リソースタイプ (* 必須)	条件キー	依存アクション
BatchCheckLayerAvailability	指定されたレジストリとリポジトリの複数のイメージレイヤーの可用性を確認する許可を付与。	読み込み	repository*
BatchDeleteImage	指定したリポジトリ内の指定したイメージのリストを削除する許可を付与。	書き込み	repository*
BatchGetImage	指定したリポジトリ内の指定したイメージの詳細情報を取得する許可を付与。	読み込み	repository*
BatchGetRepositoryScanningConfiguration	リポジトリのリストのリポジトリスキャン設定を取得するアクセス許可を付与	読み取り	repository*
BatchImportUpstreamImage [アクセス許可のみ]	アップストリームレジストリからイメージを取得し、プライベートレジストリにインポートするアクセス許可を付与	書き込み
CompleteLayerUpload	指定されたレジストリ、リポジトリ名、およびアップロード ID のイメージレイヤーアップロードが完了したことを Amazon ECR に通知する許可を付与。	書き込み	repository*
CreatePullThroughCacheRule	新しいプルスルーキャッシュルールを作成するアクセス許可を付与	書き込み			iam:CreateServiceLinkedRole
CreateRepository	イメージレポジトリを作成する許可を付与。	書き込み		aws:RequestTag/${TagKey} aws:TagKeys	ecr:TagResource
CreateRepositoryCreationTemplate	リポジトリ作成テンプレートを作成するためのアクセス許可を付与	書き込み			ecr:PutLifecyclePolicy ecr:SetRepositoryPolicy
DeleteLifecyclePolicy	指定したライフサイクルポリシーを削除する許可を付与。	書き込み	repository*
DeletePullThroughCacheRule	プルスルーキャッシュルールを削除するアクセス許可を付与	書き込み
DeleteRegistryPolicy	レジストリポリシーを削除するアクセス許可を付与	アクセス許可の管理
DeleteRepository	既存のイメージリポジトリを削除する許可を付与。	書き込み	repository*
DeleteRepositoryCreationTemplate	リポジトリ作成テンプレートを削除するためのアクセス許可を付与	書き込み
DeleteRepositoryPolicy	指定したリポジトリからリポジトリポリシーを削除する許可を付与。	アクセス許可の管理	repository*
DescribeImageReplicationStatus	レジストリ内のイメージに関するレプリケーションステータス (レプリケーションが失敗した場合の失敗の理由を含む) を取得する許可を付与	読み込み	repository*
DescribeImageScanFindings	指定したイメージのイメージスキャンの結果を記述する許可を付与。	読み込み	repository*
DescribeImages	リポジトリ内のイメージに関するメタデータ (例: イメージサイズ、イメージタグ、作成日) を取得する許可を付与。	リスト	repository*
DescribePullThroughCacheRules	プルスルーキャッシュルールを記述するアクセス許可を付与	リスト
DescribeRegistry	レジストリ設定を記述するアクセス許可を付与	読み込み
DescribeRepositories	レジストリ内のイメージリポジトリを記述する許可を付与。	読み取り	repository
DescribeRepositoryCreationTemplate	リポジトリ作成テンプレートを記述するためのアクセス許可を付与	読み取り
GetAuthorizationToken	指定したレジストリに対して有効なトークンを 12 時間取得する許可を付与。	読み込み
GetDownloadUrlForLayer	イメージレイヤーに対応するダウンロード URL を取得する許可を付与。	読み込み	repository*
GetLifecyclePolicy	指定されたライフサイクルポリシーを取得する許可を付与。	読み込み	repository*
GetLifecyclePolicyPreview	指定されたライフサイクルポリシーのプレビューリクエストの結果を取得する許可を付与。	読み込み	repository*
GetRegistryPolicy	レジストリポリシーを取得するアクセス許可を付与	読み込み
GetRegistryScanningConfiguration	レジストリスキャン設定を取得するアクセス許可を付与	読み込み
GetRepositoryPolicy	指定したリポジトリのリポジトリポリシーを取得する許可を付与。	読み込み	repository*
InitiateLayerUpload	イメージレイヤーのアップロードを予定していることを Amazon ECR に通知する許可を付与。	書き込み	repository*
ListImages	特定のリポジトリのすべてのイメージ ID を一覧表示する許可を付与。	リスト	repository*
ListTagsForResource	Amazon ECR リソースのタグを一覧表示する許可を付与。	読み込み	repository*
ListTagsForResource	Amazon ECR リソースのタグを一覧表示する許可を付与。	読み込み		aws:RequestTag/${TagKey} aws:TagKeys
PutImage	イメージに関連付けられたイメージマニフェストを作成または更新する許可を付与。	書き込み	repository*
PutImageScanningConfiguration	リポジトリのイメージスキャン設定を更新する許可を付与。	書き込み	repository*
PutImageTagMutability	リポジトリのイメージタグの変更可能性を更新する許可を付与。	書き込み	repository*
PutLifecyclePolicy	ライフサイクルポリシーを作成または更新する許可を付与。	書き込み	repository*
PutRegistryPolicy	レジストリポリシーを更新するアクセス許可を付与	アクセス許可の管理
PutRegistryScanningConfiguration	レジストリスキャン設定を更新するアクセス許可を付与	書き込み
PutReplicationConfiguration	レジストリのレプリケーション設定を更新する許可を付与	書き込み
ReplicateImage [アクセス許可のみ]	イメージをレプリケート先レジストリにレプリケートするアクセス許可を付与	書き込み	repository*
SetRepositoryPolicy	指定したリポジトリにリポジトリポリシーを適用してアクセス権限を制御する許可を付与。	Permissions management	repository*
StartImageScan	イメージスキャンを開始する許可を付与。	書き込み	repository*
StartLifecyclePolicyPreview	指定したライフサイクルポリシーのプレビューを開始する許可を付与。	書き込み	repository*
TagResource	Amazon ECR リソースにタグを付けるアクセス許可を付与	タグ付け	repository*
TagResource	Amazon ECR リソースにタグを付けるアクセス許可を付与	タグ付け		aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Amazon ECR リソースのタグを解除する許可を付与。	タグ付け	repository*
UntagResource	Amazon ECR リソースのタグを解除する許可を付与。	タグ付け		aws:TagKeys
UpdatePullThroughCacheRule	プルスルーキャッシュルールを更新するためのアクセス許可を付与	書き込み
UploadLayerPart	イメージレイヤー部分を Amazon ECR にアップロードする許可を付与。	書き込み	repository*
ValidatePullThroughCacheRule	プルスルーキャッシュルールを検証するためのアクセス許可を付与	読み取り

Amazon Elastic Container Registry で定義されるリソースタイプ

以下のリソースタイプは、このサービスによって定義され、IAM アクセス許可ポリシーステートメントの Resource エレメントで使用できます。アクションテーブルの各アクションは、そのアクションで指定できるリソースタイプを示しています。リソースタイプは、ポリシーに含めることができる条件キーを定義することもできます。これらのキーは、[リソースタイプ] テーブルの最後の列に表示されます。以下の表の列の詳細については、「リソースタイプテーブル」を参照してください。

リソースタイプ ARN 条件キー

リソースタイプ	ARN	条件キー
repository	`arn:${Partition}:ecr:${Region}:${Account}:repository/${RepositoryName}`	aws:ResourceTag/${TagKey} ecr:ResourceTag/${TagKey}

repository

arn:${Partition}:ecr:${Region}:${Account}:repository/${RepositoryName}

aws:ResourceTag/${TagKey}

ecr:ResourceTag/${TagKey}

Amazon Elastic Container Registry の条件キー

Amazon Elastic Container Service は、IAM ポリシーの Condition 要素で使用できる以下の条件キーを定義します。これらのキーを使用して、ポリシーステートメントが適用される条件をさらに絞り込むことができます。以下の表の列の詳細については、「条件キーテーブル」を参照してください。

すべてのサービスで使用できるグローバル条件キーを確認するには、「使用できるグローバル条件キー」を参照してください。

条件キー	説明	タイプ
aws:RequestTag/${TagKey}	各タグの許可された値のセットでアクセスをフィルタリングします	文字列
aws:ResourceTag/${TagKey}	リソースに関連付けられたタグ値でアクセスをフィルタリングします。	文字列
aws:TagKeys	リクエスト内の必須タグの存在でアクセスをフィルタリングします	ArrayOfString
ecr:ResourceTag/${TagKey}	リソースに関連付けられたタグ値でアクセスをフィルタリングします。	文字列

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

Amazon Elastic Block Store

Amazon Elastic Container Registry Public