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

Amazon Elastic Container Registry (服務字首：ecr) 提供以下服務特定的資源、動作和條件內容金鑰，以使用 IAM 許可政策。

參考資料：

• 了解如何設定此服務。

• 檢視可供此服務使用的 API 操作清單。

• 了解如何使用 IAM 許可政策來保護此服務及其資源。

Amazon Elastic Container Registry 定義的動作

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

「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果此欄包含資源類型，則您可以在包含該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取，則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。

「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。

注意

資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。

如需下表各欄的詳細資訊，請參閱動作資料表。

動作	描述	存取層級	資源類型 (*必填項目)	條件索引鍵	相依動作
BatchCheckLayerAvailability	准許檢查指定登錄和儲存庫檢查中多個映像層的可用性	讀取	repository*
BatchDeleteImage	准許刪除指定儲存庫中的指定映像清單	寫入	repository*
BatchGetImage	准許取得指定儲存庫中指定映像的詳細資訊	讀取	repository*
BatchGetRepositoryScanningConfiguration	准許擷取儲存庫清單的儲存庫掃描組態	讀取	repository*
BatchImportUpstreamImage [僅限許可]	准許從上游登錄檔擷取映像，並將其匯入到您的私有登錄檔	寫入
CompleteLayerUpload	准許通知 Amazon ECR，表示對於指定登錄、儲存庫名稱及上傳 ID 的映像層上傳已完成	寫入	repository*
CreatePullThroughCacheRule	准許建立新的 pull-through 快取規則	寫入			iam:CreateServiceLinkedRole
CreateRepository	准許建立映像儲存庫	寫入		aws:RequestTag/${TagKey} aws:TagKeys	ecr:TagResource
CreateRepositoryCreationTemplate	准許建立儲存庫建立範本	寫入			ecr:PutLifecyclePolicy ecr:SetRepositoryPolicy
DeleteLifecyclePolicy	准許刪除指定的生命週期政策	寫入	repository*
DeletePullThroughCacheRule	准許刪除 pull-through 快取規則	寫入
DeleteRegistryPolicy	准許刪除登錄檔政策	許可管理
DeleteRepository	准許刪除現有映像儲存庫	寫入	repository*
DeleteRepositoryCreationTemplate	准許刪除儲存庫建立範本	寫入
DeleteRepositoryPolicy	准許從指定的儲存庫刪除儲存庫政策	許可管理	repository*
DescribeImageReplicationStatus	准許擷取登錄檔中映像的複寫狀態，包括複寫失敗時的失敗原因	讀取	repository*
DescribeImageScanFindings	准許描述指定映像的映像掃描結果	讀取	repository*
DescribeImages	准許傳回關於儲存庫中映像的中繼資料，包含映像大小、映像標籤和建立日期	列出	repository*
DescribePullThroughCacheRules	准許描述 pull-through 快取規則	列出
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*
				aws:RequestTag/${TagKey} aws:TagKeys
PutImage	准許建立或更新與映像相關聯的映像資訊清單	寫入	repository*
PutImageScanningConfiguration	准許更新儲存庫映像掃描組態	寫入	repository*
PutImageTagMutability	准許更新儲存庫映像標籤可變性設定	寫入	repository*
PutLifecyclePolicy	准許建立或更新生命週期政策	寫入	repository*
PutRegistryPolicy	准許更新登錄檔政策	許可管理
PutRegistryScanningConfiguration	准許更新登錄掃描組態	寫入
PutReplicationConfiguration	准許更新登錄檔複寫組態	寫入
ReplicateImage [僅限許可]	准許將映像複寫到目的地登錄檔	寫入	repository*
SetRepositoryPolicy	准許在指定儲存庫上套用儲存庫政策，以控制存取許可	許可管理	repository*
StartImageScan	准許啟動映像掃描	寫入	repository*
StartLifecyclePolicyPreview	准許開始預覽指定的生命週期政策	寫入	repository*
TagResource	准許標記 Amazon ECR 資源	標記	repository*
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	准許取消標記 Amazon ECR 資源	標記	repository*
				aws:TagKeys
UpdatePullThroughCacheRule	准許更新 pull-through 快取規則	寫入
UploadLayerPart	准許將映像層部分上傳至 Amazon ECR	寫入	repository*
ValidatePullThroughCacheRule	准許驗證 pull-through 快取規則	讀取

Amazon Elastic Container Registry 定義的資源類型

此服務會定義下列資源類型，並可用在 IAM 許可政策陳述式的 Resource 元素中。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型資料表。

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

Amazon Elastic Container Registry 的條件索引鍵

Amazon Elastic Container Registry 會定義下列條件金鑰，可用於 IAM 政策的 Condition 元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。

若要檢視所有服務都可使用的全域條件索引鍵，請參閱可用的全域條件索引鍵。

條件索引鍵	描述	類型
aws:RequestTag/${TagKey}	依每個標籤的允許值集來篩選存取	字串
aws:ResourceTag/${TagKey}	依與資源相關聯的標籤值篩選存取權	字串
aws:TagKeys	依請求中是否存在強制性標籤來篩選存取	ArrayOfString
ecr:ResourceTag/${TagKey}	依與資源相關聯的標籤值篩選存取權	字串