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 policy 语句的 Action 元素中指定以下操作。可以使用策略授予在 Amazon 中执行操作的权限。您在策略中使用一项操作时，通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下，单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。

操作表的资源类型列指示每项操作是否支持资源级权限。如果该列没有任何值，您必须在策略语句的 Resource 元素中指定策略应用的所有资源（“*”）。通过在 IAM policy 中使用条件来筛选访问权限，以控制是否可以在资源或请求中使用特定标签键。如果操作具有一个或多个必需资源，则调用方必须具有使用这些资源来使用该操作的权限。必需资源在表中以星号 (*) 表示。如果您在 IAM policy 中使用 Resource 元素限制资源访问权限，则必须为每种必需的资源类型添加 ARN 或模式。某些操作支持多种资源类型。如果资源类型是可选的（未指示为必需），则可以选择使用一种可选资源类型。

操作表的条件键列包括可以在策略语句的 Condition 元素中指定的键。有关与服务资源关联的条件键的更多信息，请参阅资源类型表的条件键列。

注意

资源条件键在资源类型表中列出。您可以在操作表的资源类型（* 为必需）列中找到应用于某项操作的资源类型的链接。资源类型表中的资源类型包括条件密钥列，这是应用于操作表中操作的资源条件键。

有关下表中各列的详细信息，请参阅操作表。

操作	描述	访问级别	资源类型（* 为必需）	条件键	相关操作
BatchCheckLayerAvailability	授予权限以检查指定注册表和存储库中多个图像图层的可用性	Read	repository*
BatchDeleteImage	授予权限以删除指定存储库中的指定图像列表	Write	repository*
BatchGetImage	授予权限以获取指定存储库中指定图像的详细信息	Read	repository*
BatchGetRepositoryScanningConfiguration	授予权限以检索存储库列表的存储库扫描配置	Read	repository*
BatchImportUpstreamImage [仅权限]	授予权限以从上游注册表检索镜像并将其导入到您的私有注册表	Write
CompleteLayerUpload	授予权限以通知 Amazon ECR 用于指定注册表、存储库名称和上传 ID 的图像图层上传已完成	Write	repository*
CreatePullThroughCacheRule	授予创建新的推送缓存规则的权限	Write			iam:CreateServiceLinkedRole
CreateRepository	授予权限以创建图像存储库	Write		aws:RequestTag/${TagKey} aws:TagKeys	ecr:TagResource
CreateRepositoryCreationTemplate	授予创建存储库创建模板的权限	Write			ecr:PutLifecyclePolicy ecr:SetRepositoryPolicy
DeleteLifecyclePolicy	授予权限以删除指定的生命周期策略	Write	repository*
DeletePullThroughCacheRule	授予删除推送缓存规则的权限	Write
DeleteRegistryPolicy	授予删除注册表策略的权限	权限管理
DeleteRepository	授予权限以删除现有图像存储库	Write	repository*
DeleteRepositoryCreationTemplate	授予删除存储库创建模板的权限	Write
DeleteRepositoryPolicy	授予权限以从指定存储库中删除存储库策略	权限管理	repository*
DescribeImageReplicationStatus	授予权限以检索注册表中的镜像的复制状态，包括复制失败时的失败原因	Read	repository*
DescribeImageScanFindings	授予权限以描述指定图像的图像扫描结果	Read	repository*
DescribeImages	授予权限以获取有关存储库中图像的元数据，包括图像大小、图像标签和创建日期	List	repository*
DescribePullThroughCacheRules	授予描述推送缓存规则的权限	List
DescribeRegistry	授予权限以描述注册表设置	Read
DescribeRepositories	授予权限以描述注册表中的图像存储库	Read	repository
DescribeRepositoryCreationTemplate	授予描述存储库创建模板的权限	Read
GetAuthorizationToken	授予权限以检索 12 小时内对指定注册表有效的令牌	Read
GetDownloadUrlForLayer	授予权限以检索与图像图层对应的下载 URL	Read	repository*
GetLifecyclePolicy	授予权限以检索指定的生命周期策略	Read	repository*
GetLifecyclePolicyPreview	授予权限以检索指定的生命周期策略预览请求的结果	Read	repository*
GetRegistryPolicy	授予检索注册表策略的权限	Read
GetRegistryScanningConfiguration	授予权限以检索注册表扫描配置	Read
GetRepositoryPolicy	授予权限以检索指定存储库的存储库策略	Read	repository*
InitiateLayerUpload	授予权限以通知 Amazon ECR 您打算上传图像图层	Write	repository*
ListImages	授予权限以列出给定存储库的所有图像 ID	List	repository*
ListTagsForResource	授予权限以列出 Amazon ECR 资源标签	Read	repository*
ListTagsForResource	授予权限以列出 Amazon ECR 资源标签	Read		aws:RequestTag/${TagKey} aws:TagKeys
PutImage	授予权限以创建或更新与图像关联的图像清单	Write	repository*
PutImageScanningConfiguration	授予权限以更新存储库的图像扫描配置	Write	repository*
PutImageTagMutability	授予权限以更新存储库的图像标签可变性设置	Write	repository*
PutLifecyclePolicy	授予权限以创建或更新生命周期策略	Write	repository*
PutRegistryPolicy	授予更新注册表策略的权限	权限管理
PutRegistryScanningConfiguration	授予权限以更新注册表扫描配置	Write
PutReplicationConfiguration	授予更新注册表的复制配置的权限	Write
ReplicateImage [仅权限]	授予将映像复制到目标注册表的权限	Write	repository*
SetRepositoryPolicy	授予权限以在指定存储库上应用存储库策略来控制访问权限	Permissions management	repository*
StartImageScan	授予权限以启动图像扫描	Write	repository*
StartLifecyclePolicyPreview	授予权限以启动指定生命周期策略的预览	Write	repository*
TagResource	授予权限以标记 Amazon ECR 资源	Tagging	repository*
TagResource	授予权限以标记 Amazon ECR 资源	Tagging		aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	授予权限以取消标记 Amazon ECR 资源	Tagging	repository*
UntagResource	授予权限以取消标记 Amazon ECR 资源	Tagging		aws:TagKeys
UpdatePullThroughCacheRule	授予更新直通式缓存规则的权限	Write
UploadLayerPart	授予权限以将图像图层部分上传到 Amazon ECR	Write	repository*
ValidatePullThroughCacheRule	授予验证直通式缓存规则的权限	Read

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 policy 的 Condition 元素中使用的条件键。您可以使用这些键进一步细化应用策略语句的条件。有关下表中各列的详细信息，请参阅条件键表。

要查看适用于所有服务的全局条件键，请参阅可用的全局条件键。

条件键	描述	类型
aws:RequestTag/${TagKey}	按每个标签的允许值集筛选访问	字符串
aws:ResourceTag/${TagKey}	按与资源关联的标签值筛选访问权限	字符串
aws:TagKeys	按请求中是否具有必需标签来筛选访问	字符串数组
ecr:ResourceTag/${TagKey}	按与资源关联的标签值筛选访问权限	字符串

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

Amazon Elastic Block Store

Amazon Elastic Container Service