Amazon Elastic Container Registry 的動作、資源與條件索引鍵

Amazon Elastic Container Registry （服務字首：ecr) 提供下列服務特定的操作、資源、動作和條件索引鍵，可用於 IAM 許可政策。

參考資料：

了解如何設定此服務。
檢視可供此服務使用的 API 操作清單。
了解如何使用 IAM 許可政策來保護此服務及其資源。
檢視此服務的程式設計服務授權參考。

主題

Amazon Elastic Container Registry 定義的 API 操作
Amazon Elastic Container Registry 定義的動作
Amazon Elastic Container Registry 的僅限許可動作
Amazon Elastic Container Registry 定義的資源類型
Amazon Elastic Container Registry 的條件索引鍵

Amazon Elastic Container Registry 定義的 API 操作

下表將 API 操作映射至其授權的 IAM 動作。只會列出具有指定 API 和動作靜態值的條件金鑰；如需每個動作支援的完整條件金鑰集，請參閱動作表格。

作業	IAM 動作	條件鍵	可能的值 (s)	存取層級
BatchCheckLayerAvailability	ecr：BatchCheckLayerAvailability			讀取
BatchDeleteImage	ecr：BatchDeleteImage			寫入
BatchGetImage	ecr：BatchGetImage			讀取
	ecr：BatchImportUpstreamImage			寫入
	ecr：CreateRepository			寫入
	ecr：TagResource			標記、寫入
BatchGetRepositoryScanningConfiguration	ecr：BatchGetRepositoryScanningConfiguration			讀取
CompleteLayerUpload	ecr：CompleteLayerUpload			寫入
CreatePullThroughCacheRule	ecr：CreatePullThroughCacheRule			寫入
CreatePullThroughCacheRule	iam：PassRole	iam:PassedToService	ecr.amazonaws.com	寫入
CreateRepository	ecr：CreateRepository			寫入
CreateRepository	ecr：TagResource			標記、寫入
CreateRepositoryCreationTemplate	ecr：CreateRepository			寫入
	ecr：CreateRepositoryCreationTemplate			寫入
	ecr：PutLifecyclePolicy			寫入
	ecr：SetRepositoryPolicy			許可管理、寫入
	iam：PassRole	iam:PassedToService	ecr.amazonaws.com	寫入
DeleteLifecyclePolicy	ecr：DeleteLifecyclePolicy			寫入
DeletePullThroughCacheRule	ecr：DeletePullThroughCacheRule			寫入
DeleteRegistryPolicy	ecr：DeleteRegistryPolicy			許可管理、寫入
DeleteRepository	ecr：DeleteRepository			寫入
DeleteRepositoryCreationTemplate	ecr：DeleteRepositoryCreationTemplate			寫入
DeleteRepositoryPolicy	ecr：DeleteRepositoryPolicy			許可管理、寫入
DeleteSigningConfiguration	ecr：DeleteSigningConfiguration			寫入
DeregisterPullTimeUpdateExclusion	ecr：DeregisterPullTimeUpdateExclusion			寫入
DescribeImageReplicationStatus	ecr：DescribeImageReplicationStatus			讀取
DescribeImageScanFindings	ecr：DescribeImageScanFindings			讀取
DescribeImageSigningStatus	ecr：DescribeImageSigningStatus			讀取
DescribeImages	ecr：DescribeImages			清單
DescribePullThroughCacheRules	ecr：DescribePullThroughCacheRules			清單
DescribeRegistry	ecr：DescribeRegistry			讀取
DescribeRepositories	ecr：DescribeRepositories			讀取
DescribeRepositoryCreationTemplates	ecr：DescribeRepositoryCreationTemplates			讀取
GetAccountSetting	ecr：GetAccountSetting			讀取
GetAuthorizationToken	ecr：GetAuthorizationToken			讀取
GetDownloadUrlForLayer	ecr：BatchImportUpstreamImage			寫入
GetDownloadUrlForLayer	ecr：GetDownloadUrlForLayer			讀取
GetLifecyclePolicy	ecr：GetLifecyclePolicy			讀取
GetLifecyclePolicyPreview	ecr：GetLifecyclePolicyPreview			讀取
GetRegistryPolicy	ecr：GetRegistryPolicy			讀取
GetRegistryScanningConfiguration	ecr：GetRegistryScanningConfiguration			讀取
GetRepositoryPolicy	ecr：GetRepositoryPolicy			讀取
GetSigningConfiguration	ecr：GetSigningConfiguration			讀取
InitiateLayerUpload	ecr：InitiateLayerUpload			寫入
ListImageReferrers	ecr：BatchGetImage			讀取
	ecr：BatchImportUpstreamImage			寫入
	ecr：CreateRepository			寫入
ListImages	ecr：ListImages			清單
ListPullTimeUpdateExclusions	ecr：ListPullTimeUpdateExclusions			清單
ListTagsForResource	ecr：ListTagsForResource			讀取
PutAccountSetting	ecr：PutAccountSetting			寫入
PutImage	ecr：PutImage			寫入
PutImageScanningConfiguration	ecr：PutImageScanningConfiguration			寫入
PutImageTagMutability	ecr：PutImageTagMutability			寫入
PutLifecyclePolicy	ecr：PutLifecyclePolicy			寫入
PutRegistryPolicy	ecr：PutRegistryPolicy			許可管理、寫入
PutRegistryScanningConfiguration	ecr：PutRegistryScanningConfiguration			寫入
PutReplicationConfiguration	ecr：PutReplicationConfiguration			寫入
PutSigningConfiguration	ecr：PutSigningConfiguration			寫入
RegisterPullTimeUpdateExclusion	ecr：RegisterPullTimeUpdateExclusion			寫入
SetRepositoryPolicy	ecr：SetRepositoryPolicy			許可管理、寫入
StartImageScan	ecr：StartImageScan			寫入
StartLifecyclePolicyPreview	ecr：StartLifecyclePolicyPreview			寫入
TagResource	ecr：TagResource			標記、寫入
UntagResource	ecr：UntagResource			標記、寫入
UpdateImageStorageClass	ecr：UpdateImageStorageClass			寫入
UpdatePullThroughCacheRule	ecr：UpdatePullThroughCacheRule			寫入
UpdatePullThroughCacheRule	iam：PassRole	iam:PassedToService	ecr.amazonaws.com	寫入
UpdateRepositoryCreationTemplate	ecr：CreateRepository			寫入
	ecr：PutLifecyclePolicy			寫入
	ecr：SetRepositoryPolicy			許可管理、寫入
	ecr：UpdateRepositoryCreationTemplate			寫入
	iam：PassRole	iam:PassedToService	ecr.amazonaws.com	寫入
UploadLayerPart	ecr：UploadLayerPart			寫入
ValidatePullThroughCacheRule	ecr：ValidatePullThroughCacheRule			讀取

Amazon Elastic Container Registry 定義的動作

您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。在政策中使用動作時，通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。

動作	說明	資源類型 (*必填項目)	條件索引鍵	存取層級
BatchCheckLayerAvailability	准許檢查指定登錄和儲存庫檢查中多個映像層的可用性	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	讀取
BatchDeleteImage	准許刪除指定儲存庫中的指定映像清單	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	寫入
BatchGetImage	准許取得指定儲存庫中指定映像的詳細資訊	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	讀取
BatchGetRepositoryScanningConfiguration	准許擷取儲存庫清單的儲存庫掃描組態	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	讀取
CompleteLayerUpload	准許通知 Amazon ECR，表示對於指定登錄、儲存庫名稱及上傳 ID 的映像層上傳已完成	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	寫入
CreatePullThroughCacheRule	准許建立新的 pull-through 快取規則			寫入
CreateRepository	准許建立映像儲存庫	儲存庫*	aws：RequestTag/${TagKey} aws：ResourceTag/${TagKey} aws:TagKeys ecr：ResourceTag/${TagKey}	寫入
CreateRepositoryCreationTemplate	准許建立儲存庫建立範本			寫入
DeleteLifecyclePolicy	准許刪除指定的生命週期政策	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	寫入
DeletePullThroughCacheRule	准許刪除 pull-through 快取規則			寫入
DeleteRegistryPolicy	准許刪除登錄檔政策			許可管理、寫入
DeleteRepository	准許刪除現有映像儲存庫	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	寫入
DeleteRepositoryCreationTemplate	准許刪除儲存庫建立範本			寫入
DeleteRepositoryPolicy	准許從指定的儲存庫刪除儲存庫政策	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	許可管理、寫入
DeleteSigningConfiguration	准許刪除登錄檔的簽署組態			寫入
DeregisterPullTimeUpdateExclusion	准許取消註冊提取時間更新排除			寫入
DescribeImageReplicationStatus	准許擷取登錄檔中映像的複寫狀態，包括複寫失敗時的失敗原因	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	讀取
DescribeImageScanFindings	准許描述指定映像的映像掃描結果	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	讀取
DescribeImageSigningStatus	准許擷取指定登錄檔中映像的簽署狀態	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	讀取
DescribeImages	准許傳回關於儲存庫中映像的中繼資料，包含映像大小、映像標籤和建立日期	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	清單
DescribePullThroughCacheRules	准許描述 pull-through 快取規則			清單
DescribeRegistry	准許描述登錄檔設定			讀取
DescribeRepositories	准許在登錄中描述映像儲存庫	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	讀取
DescribeRepositoryCreationTemplates	准許描述儲存庫建立範本			讀取
GetAccountSetting	准許擷取帳戶設定		ecr：AccountSetting	讀取
GetAuthorizationToken	准許擷取對指定登錄有效期為 12 小時的字符			讀取
GetDownloadUrlForLayer	准許擷取與映像層對應的下載 URL	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	讀取
GetLifecyclePolicy	准許擷取指定的生命週期政策	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	讀取
GetLifecyclePolicyPreview	准許擷取指定的生命週期政策預覽要求結果	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	讀取
GetRegistryPolicy	准許擷取登錄政策			讀取
GetRegistryScanningConfiguration	准許擷取登錄掃描組態			讀取
GetRepositoryPolicy	准許從指定的儲存庫擷取儲存庫政策	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	讀取
GetSigningConfiguration	准許擷取登錄檔的簽署組態			讀取
InitiateLayerUpload	准許通知您要上傳映像層 Amazon ECR	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	寫入
ListImages	准許列出指定儲存庫的所有映像 ID	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	清單
ListPullTimeUpdateExclusions	准許列出登錄檔的提取時間更新排除			清單
ListTagsForResource	准許列出 Amazon ECR 資源的標籤清單	儲存庫*	aws：RequestTag/${TagKey} aws：ResourceTag/${TagKey} aws:TagKeys ecr：ResourceTag/${TagKey}	讀取
PutAccountSetting	准許更新帳戶設定		ecr：AccountSetting	寫入
PutImage	准許建立或更新與映像相關聯的映像資訊清單	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	寫入
PutImageScanningConfiguration	准許更新儲存庫映像掃描組態	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	寫入
PutImageTagMutability	准許更新儲存庫映像標籤可變性設定	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	寫入
PutLifecyclePolicy	准許建立或更新生命週期政策	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	寫入
PutRegistryPolicy	准許更新登錄檔政策			許可管理、寫入
PutRegistryScanningConfiguration	准許更新登錄掃描組態			寫入
PutReplicationConfiguration	准許更新登錄檔複寫組態			寫入
PutSigningConfiguration	准許更新登錄檔的簽署組態			寫入
RegisterPullTimeUpdateExclusion	准許註冊提取時間更新排除			寫入
SetRepositoryPolicy	准許在指定儲存庫上套用儲存庫政策，以控制存取許可	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	許可管理、寫入
StartImageScan	准許啟動映像掃描	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	寫入
StartLifecyclePolicyPreview	准許開始預覽指定的生命週期政策	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	寫入
TagResource	准許標記 Amazon ECR 資源	儲存庫*	aws：RequestTag/${TagKey} aws：ResourceTag/${TagKey} aws:TagKeys ecr：ResourceTag/${TagKey}	標記、寫入
UntagResource	准許取消標記 Amazon ECR 資源	儲存庫*	aws：ResourceTag/${TagKey} aws:TagKeys ecr：ResourceTag/${TagKey}	標記、寫入
UpdateImageStorageClass	准許在指定的儲存庫中取得指定映像的儲存類別更新	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	寫入
UpdatePullThroughCacheRule	准許更新 pull-through 快取規則			寫入
UpdateRepositoryCreationTemplate	准許更新儲存庫建立範本			寫入
UploadLayerPart	准許將映像層部分上傳至 Amazon ECR	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	寫入
ValidatePullThroughCacheRule	准許驗證 pull-through 快取規則			讀取

Amazon Elastic Container Registry 的僅限許可動作

下列動作是由 Amazon Elastic Container Registry 定義，但無法透過任何 API 操作直接叫用。它們只能在 IAM 政策陳述式中使用，以授予或拒絕許可。

動作	說明	資源類型 (*必填項目)	條件索引鍵	存取層級
BatchImportUpstreamImage	准許從上游登錄檔擷取映像，並將其匯入到您的私有登錄檔	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	寫入
GetImageCopyStatus	准許擷取映像複本的狀態	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	讀取
ReplicateImage	准許將映像複寫到目的地登錄檔	儲存庫*	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}	寫入

動作

說明

資源類型 (*必填項目)

條件索引鍵

存取層級

BatchImportUpstreamImage

准許從上游登錄檔擷取映像，並將其匯入到您的私有登錄檔

儲存庫*

aws：ResourceTag/${TagKey}

ecr：ResourceTag/${TagKey}

寫入

GetImageCopyStatus

准許擷取映像複本的狀態

儲存庫*

aws：ResourceTag/${TagKey}

ecr：ResourceTag/${TagKey}

讀取

ReplicateImage

准許將映像複寫到目的地登錄檔

儲存庫*

aws：ResourceTag/${TagKey}

ecr：ResourceTag/${TagKey}

寫入

Amazon Elastic Container Registry 定義的資源類型

此服務會定義下列資源類型，並可用在 IAM 許可政策陳述式的 Resource 元素中。

資源類型	ARN	條件索引鍵
儲存庫	arn：${Partition}：ecr：${Region}：${Account}：repository/${RepositoryName}	aws：ResourceTag/${TagKey} ecr：ResourceTag/${TagKey}

資源類型

ARN

條件索引鍵

儲存庫

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

aws：ResourceTag/${TagKey}

ecr：ResourceTag/${TagKey}

Amazon Elastic Container Registry 的條件索引鍵

Amazon Elastic Container Registry 會定義下列條件金鑰，可用於 IAM 政策的 Condition 元素。

條件索引鍵	描述	Type
aws:RequestTag/${TagKey}	依每個標籤的允許值集來篩選存取	String
aws:ResourceTag/${TagKey}	依與資源相關聯的標籤值篩選存取權	String
aws:TagKeys	依請求中是否存在強制性標籤來篩選存取	ArrayOfString
ecr：AccountSetting	依 ECR 帳戶設定名稱篩選存取權	String
ecr：ResourceTag/${TagKey}	依與資源相關聯的標籤值篩選存取權	String

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

Amazon Elastic Block Store (ebs)

Amazon Elastic Container Registry Public (ecr-public)