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命令的存取。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。

「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 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	准許建立映像儲存庫	寫入	repository*		ecr:TagResource
CreateRepository	准許建立映像儲存庫	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateRepositoryCreationTemplate	准許建立儲存庫建立範本	寫入			ecr:CreateRepository ecr:PutLifecyclePolicy ecr:SetRepositoryPolicy iam:CreateServiceLinkedRole iam:PassRole
DeleteLifecyclePolicy	准許刪除指定的生命週期政策	寫入	repository*
DeletePullThroughCacheRule	准許刪除 pull-through 快取規則	寫入
DeleteRegistryPolicy	准許刪除登錄檔政策	許可管理
DeleteRepository	准許刪除現有映像儲存庫	寫入	repository*
DeleteRepositoryCreationTemplate	准許刪除儲存庫建立範本	寫入
DeleteRepositoryPolicy	准許從指定的儲存庫刪除儲存庫政策	許可管理	repository*
DescribeImageReplicationStatus	准許擷取登錄檔中映像的複寫狀態，包括複寫失敗時的失敗原因	讀取	repository*
DescribeImageScanFindings	准許描述指定映像的映像掃描結果	讀取	repository*
DescribeImages	准許傳回關於儲存庫中映像的中繼資料，包含映像大小、映像標籤和建立日期	列出	repository*
DescribePullThroughCacheRules	准許描述 pull-through 快取規則	列出
DescribeRegistry	准許描述登錄檔設定	讀取
DescribeRepositories	准許在登錄中描述映像儲存庫	讀取	repository*
DescribeRepositoryCreationTemplates	准許描述儲存庫建立範本	讀取
GetAccountSetting	准許擷取帳戶設定	讀取
GetAuthorizationToken	准許擷取對指定登錄有效期為 12 小時的字符	讀取
GetDownloadUrlForLayer	准許擷取URL對應至映像層的下載	讀取	repository*
GetLifecyclePolicy	准許擷取指定的生命週期政策	讀取	repository*
GetLifecyclePolicyPreview	准許擷取指定的生命週期政策預覽要求結果	讀取	repository*
GetRegistryPolicy	准許擷取登錄政策	讀取
GetRegistryScanningConfiguration	准許擷取登錄掃描組態	讀取
GetRepositoryPolicy	准許從指定的儲存庫擷取儲存庫政策	讀取	repository*
InitiateLayerUpload	准許通知 Amazon ECR 您打算上傳映像層	寫入	repository*
ListImages	准許列出IDs指定儲存庫的所有映像	清單	repository*
ListTagsForResource	准許列出 Amazon ECR 資源的標籤	讀取	repository*
ListTagsForResource	准許列出 Amazon ECR 資源的標籤	讀取		aws:RequestTag/${TagKey} aws:TagKeys
PutAccountSetting	准許更新帳戶設定	寫入
PutImage	准許建立或更新與映像相關聯的映像資訊清單	寫入	repository*
PutImageScanningConfiguration	准許更新儲存庫映像掃描組態	寫入	repository*
PutImageTagMutability	准許更新儲存庫映像標籤可變性設定	寫入	repository*
PutLifecyclePolicy	准許建立或更新生命週期政策	寫入	repository*
PutRegistryPolicy	准許更新登錄檔政策	許可管理
PutRegistryScanningConfiguration	准許更新登錄掃描組態	寫入
PutReplicationConfiguration	准許更新登錄檔複寫組態	寫入			iam:CreateServiceLinkedRole
ReplicateImage [僅限許可]	准許將映像複寫到目的地登錄檔	寫入	repository*
SetRepositoryPolicy	准許在指定儲存庫上套用儲存庫政策，以控制存取許可	許可管理	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	准許更新 pull-through 快取規則	寫入
UpdateRepositoryCreationTemplate	准許更新儲存庫建立範本	寫入			ecr:CreateRepository ecr:PutLifecyclePolicy ecr:SetRepositoryPolicy iam:CreateServiceLinkedRole iam:PassRole
UploadLayerPart	准許將映像層部分上傳至 Amazon ECR	寫入	repository*
ValidatePullThroughCacheRule	准許驗證 pull-through 快取規則	讀取

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 Registry 定義下列條件索引鍵，可用於IAM政策的 Condition元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。

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

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

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

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

文件慣用形式

Amazon Elastic Block Store

Amazon Elastic Container Registry Public