Amazon Elastic Container Registry 的操作、资源和条件键 - 服务授权参考
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

Amazon Elastic Container Registry 的操作、资源和条件键

Amazon Elastic Container Registry(服务前缀:ecr)提供以下服务特定的资源、操作和条件上下文键以在 IAM 权限策略中使用。

参考:

Amazon Elastic Container Registry 定义的操作

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

资源类型列指示每项操作是否支持资源级权限。如果该列没有任何值,您必须在策略语句的 Resource 元素中指定所有资源(“*”)。如果该列包含一种资源类型,则可以在含有该操作的语句中指定该类型的 ARN。必需资源在表中以星号 (*) 表示。如果在使用该操作的语句中指定资源级权限 ARN,则它必须属于该类型。某些操作支持多种资源类型。如果资源类型是可选的(未指示为必需),则可以选择使用一种类型而不使用其他类型。

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

操作 描述 访问级别 资源类型(* 为必需) 条件键 相关操作
BatchCheckLayerAvailability 授予权限以检查指定注册表和存储库中多个图像图层的可用性 Read

repository*

BatchDeleteImage 授予权限以删除指定存储库中的指定图像列表 Write

repository*

BatchGetImage 授予权限以获取指定存储库中指定图像的详细信息 读取

repository*

BatchGetRepositoryScanningConfiguration 授予权限以检索存储库列表的存储库扫描配置 读取

repository*

BatchImportUpstreamImage 授予权限以从上游注册表检索镜像并将其导入到您的私有注册表 写入
CompleteLayerUpload 授予权限以通知 Amazon ECR 用于指定注册表、存储库名称和上传 ID 的图像图层上传已完成 写入

repository*

CreatePullThroughCacheRule 授予创建新的推送缓存规则的权限 写入
CreateRepository 授予权限以创建图像存储库 Write

aws:RequestTag/${TagKey}

aws:TagKeys

DeleteLifecyclePolicy 授予权限以删除指定的生命周期策略 写入

repository*

DeletePullThroughCacheRule 授予删除推送缓存规则的权限 写入
DeleteRegistryPolicy 授予删除注册表策略的权限 权限管理
DeleteRepository 授予权限以删除现有图像存储库 Write

repository*

DeleteRepositoryPolicy 授予权限以从指定存储库中删除存储库策略 权限管理

repository*

DescribeImageReplicationStatus 授予权限以检索注册表中的镜像的复制状态,包括复制失败时的失败原因 读取

repository*

DescribeImageScanFindings 授予权限以描述指定图像的图像扫描结果 Read

repository*

DescribeImages 授予权限以获取有关存储库中图像的元数据,包括图像大小、图像标签和创建日期 列表

repository*

DescribePullThroughCacheRules 授予描述推送缓存规则的权限 列表
DescribeRegistry 授予权限以描述注册表设置 Read
DescribeRepositories 授予权限以描述注册表中的图像存储库 读取

repository

GetAuthorizationToken 授予权限以检索 12 小时内对指定注册表有效的令牌 Read
GetDownloadUrlForLayer 授予权限以检索与图像图层对应的下载 URL Read

repository*

GetLifecyclePolicy 授予权限以检索指定的生命周期策略 Read

repository*

GetLifecyclePolicyPreview 授予权限以检索指定的生命周期策略预览请求的结果 Read

repository*

GetRegistryPolicy 授予检索注册表策略的权限 读取
GetRegistryScanningConfiguration 授予权限以检索注册表扫描配置 读取
GetRepositoryPolicy 授予权限以检索指定存储库的存储库策略 Read

repository*

InitiateLayerUpload 授予权限以通知 Amazon ECR 您打算上传图像图层 Write

repository*

ListImages 授予权限以列出给定存储库的所有图像 ID List

repository*

ListTagsForResource 授予权限以列出 Amazon ECR 资源标签 Read

repository*

aws:RequestTag/${TagKey}

aws:TagKeys

PutImage 授予权限以创建或更新与图像关联的图像清单 Write

repository*

PutImageScanningConfiguration 授予权限以更新存储库的图像扫描配置 Write

repository*

PutImageTagMutability 授予权限以更新存储库的图像标签可变性设置 Write

repository*

PutLifecyclePolicy 授予权限以创建或更新生命周期策略 Write

repository*

PutRegistryPolicy 授予更新注册表策略的权限 权限管理
PutRegistryScanningConfiguration 授予权限以更新注册表扫描配置 写入
PutReplicationConfiguration 授予更新注册表的复制配置的权限 写入
ReplicateImage [仅权限] 授予将映像复制到目标注册表的权限 Write

repository*

SetRepositoryPolicy 授予权限以在指定存储库上应用存储库策略来控制访问权限 Permissions management

repository*

StartImageScan 授予权限以启动图像扫描 Write

repository*

StartLifecyclePolicyPreview 授予权限以启动指定生命周期策略的预览 Write

repository*

TagResource 授予权限以标记 Amazon ECR 资源 Tagging

repository*

aws:RequestTag/${TagKey}

aws:TagKeys

UntagResource 授予权限以取消标记 Amazon ECR 资源 Tagging

repository*

aws:RequestTag/${TagKey}

aws:TagKeys

UploadLayerPart 授予权限以将图像图层部分上传到 Amazon ECR Write

repository*

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 按请求中是否具有必需标签来筛选访问 字符串数组
ecr:ResourceTag/${TagKey} 按与资源关联的标签值筛选访问权限 字符串