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

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}	按每个标签的允许值集筛选访问	String
aws:ResourceTag/${TagKey}	按与资源关联的标签值筛选访问权限	String
aws:TagKeys	按请求中是否具有必需标签来筛选访问	ArrayOfString
ecr:ResourceTag/${TagKey}	按与资源关联的标签值筛选访问权限	String