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

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Amazon EC2 Image Builder 的操作、资源和条件键

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

参考:

Amazon EC2 Image Builder 定义的操作

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

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

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

操作 描述 访问级别 资源类型(* 为必需) 条件键 相关操作
CancelImageCreation 授予权限以取消映像创建 写入

image*

CreateComponent 授予权限以创建新组件 写入

component*

iam:CreateServiceLinkedRole

imagebuilder:TagResource

kms:Encrypt

kms:GenerateDataKey

kms:GenerateDataKeyWithoutPlaintext

kmsKey

aws:RequestTag/${TagKey}

aws:TagKeys

CreateContainerRecipe 授予权限以创建新的容器配方 写入

containerRecipe*

ecr:DescribeImages

ecr:DescribeRepositories

iam:CreateServiceLinkedRole

imagebuilder:GetComponent

imagebuilder:GetImage

imagebuilder:TagResource

kms:Encrypt

kms:GenerateDataKey

kms:GenerateDataKeyWithoutPlaintext

aws:RequestTag/${TagKey}

aws:TagKeys

CreateDistributionConfiguration 授予权限以创建新的分配配置 写入

distributionConfiguration*

iam:CreateServiceLinkedRole

imagebuilder:TagResource

aws:RequestTag/${TagKey}

aws:TagKeys

CreateImage 授予权限以创建新的映像 写入

image*

iam:CreateServiceLinkedRole

imagebuilder:GetContainerRecipe

imagebuilder:GetDistributionConfiguration

imagebuilder:GetImageRecipe

imagebuilder:GetInfrastructureConfiguration

imagebuilder:TagResource

aws:RequestTag/${TagKey}

aws:TagKeys

CreateImagePipeline 授予权限以创建新的映像管道 写入

imagePipeline*

iam:CreateServiceLinkedRole

imagebuilder:GetContainerRecipe

imagebuilder:GetImageRecipe

imagebuilder:TagResource

aws:RequestTag/${TagKey}

aws:TagKeys

CreateImageRecipe 授予权限以创建新的映像配方 写入

imageRecipe*

ec2:DescribeImages

iam:CreateServiceLinkedRole

imagebuilder:GetComponent

imagebuilder:GetImage

imagebuilder:TagResource

aws:RequestTag/${TagKey}

aws:TagKeys

CreateInfrastructureConfiguration 授予权限以创建新的基础设施配置 写入

infrastructureConfiguration*

iam:CreateServiceLinkedRole

iam:PassRole

imagebuilder:TagResource

sns:Publish

aws:RequestTag/${TagKey}

aws:TagKeys

imagebuilder:CreatedResourceTagKeys

imagebuilder:CreatedResourceTag/<key>

DeleteComponent 授予删除组件的权限 写入

component*

DeleteContainerRecipe 授予删除容器配方的权限 写入

containerRecipe*

DeleteDistributionConfiguration 授予权限以删除分配配置 写入

distributionConfiguration*

DeleteImage 授予权限以删除映像 写入

image*

DeleteImagePipeline 授予权限以删除映像管道 写入

imagePipeline*

DeleteImageRecipe 授予权限以删除映像配方 写入

imageRecipe*

DeleteInfrastructureConfiguration 授予权限以删除基础设施配置 写入

infrastructureConfiguration*

GetComponent 授予权限以查看有关组件的详细信息 Read

component*

kms:Decrypt

GetComponentPolicy 授予权限以查看与组件关联的资源策略 Read

component*

GetContainerRecipe 授予权限以查看有关容器配方的详细信息 Read

containerRecipe*

GetContainerRecipePolicy 授予权限以查看与容器配方关联的资源策略 Read

containerRecipe*

GetDistributionConfiguration 授予权限以查看有关分配配置的详细信息 Read

distributionConfiguration*

GetImage 授予权限以查看有关映像的详细信息 Read

image*

aws:ResourceTag/${TagKey}

GetImagePipeline 授予权限以查看有关映像管道的详细信息 Read

imagePipeline*

GetImagePolicy 授予权限以查看与映像关联的资源策略 Read

image*

GetImageRecipe 授予权限以查看有关映像配方的详细信息 Read

imageRecipe*

GetImageRecipePolicy 授予权限以查看与映像配方关联的资源策略 Read

imageRecipe*

GetInfrastructureConfiguration 授予权限以查看有关基础设施配置的详细信息 Read

infrastructureConfiguration*

ImportComponent 授予权限以导入新组件 写入

component*

iam:CreateServiceLinkedRole

imagebuilder:TagResource

kms:Encrypt

kms:GenerateDataKey

kms:GenerateDataKeyWithoutPlaintext

kmsKey

aws:RequestTag/${TagKey}

aws:TagKeys

ListComponentBuildVersions 授予权限以列出您账户中的组件内部版本 List

componentVersion*

ListComponents 授予权限以列出您的账户拥有或与之共享的组件版本 List
ListContainerRecipes 授予权限以列出您账户拥有或与之共享的容器配方 List
ListDistributionConfigurations 授予权限以列出您账户中的分配配置 List
ListImageBuildVersions 授予权限以列出您账户中的映像内部版本 List

imageVersion*

ListImagePackages 授予权限以返回指定映像上安装的软件包列表 List

image*

aws:ResourceTag/${TagKey}

ListImagePipelineImages 授予权限以返回由指定管道创建的映像的列表 List

imagePipeline*

ListImagePipelines 授予权限以列出您账户中的映像管道 List
ListImageRecipes 授予权限以列出您账户拥有或与之共享的映像配方 List
ListImages 授予权限以列出您账户拥有或与之共享的映像版本 List
ListInfrastructureConfigurations 授予权限以列出您账户中的基础设施配置 List
ListTagsForResource 授予权限以列出 Image Builder 资源的标签 Read

component

distributionConfiguration

image

imagePipeline

imageRecipe

infrastructureConfiguration

aws:ResourceTag/${TagKey}

PutComponentPolicy 授予权限以设置与组件关联的资源策略 权限管理

component*

PutContainerRecipePolicy 授予权限以设置与容器配方关联的资源策略 权限管理

containerRecipe*

PutImagePolicy 授予权限以设置与映像关联的资源策略 权限管理

image*

PutImageRecipePolicy 授予权限以设置与映像配方关联的资源策略 权限管理

imageRecipe*

StartImagePipelineExecution 授予权限以从管道创建新的映像 写入

imagePipeline*

iam:CreateServiceLinkedRole

imagebuilder:GetImagePipeline

TagResource 授予权限以标记 Image Builder 资源 标记

component

containerRecipe

distributionConfiguration

image

imagePipeline

imageRecipe

infrastructureConfiguration

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

UntagResource 授予权限以取消标记 Image Builder 资源 标记

component

containerRecipe

distributionConfiguration

image

imagePipeline

imageRecipe

infrastructureConfiguration

aws:ResourceTag/${TagKey}

aws:TagKeys

UpdateDistributionConfiguration 授予权限以更新现有分配配置 写入

distributionConfiguration*

UpdateImagePipeline 授予权限以更新现有映像管道 写入

imagePipeline*

UpdateInfrastructureConfiguration 授予权限以更新现有基础设施配置 写入

infrastructureConfiguration*

iam:PassRole

sns:Publish

aws:ResourceTag/${TagKey}

imagebuilder:CreatedResourceTagKeys

imagebuilder:CreatedResourceTag/<key>

Amazon EC2 Image Builder 定义的资源类型

以下资源类型是由该服务定义的,可以在 IAM 权限策略语句的 Resource 元素中使用这些资源类型。操作表中的每个操作标识了可以使用该操作指定的资源类型。您也可以在策略中包含条件键,从而定义资源类型。这些键显示在表的最后一列。有关下表中各列的详细信息,请参阅 资源类型表

资源类型 ARN 条件键
component arn:${Partition}:imagebuilder:${Region}:${Account}:component/${ComponentName}/${ComponentVersion}/${ComponentBuildVersion}

aws:ResourceTag/${TagKey}

componentVersion arn:${Partition}:imagebuilder:${Region}:${Account}:component/${ComponentName}/${ComponentVersion}

aws:ResourceTag/${TagKey}

distributionConfiguration arn:${Partition}:imagebuilder:${Region}:${Account}:distribution-configuration/${DistributionConfigurationName}

aws:ResourceTag/${TagKey}

image arn:${Partition}:imagebuilder:${Region}:${Account}:image/${ImageName}/${ImageVersion}/${ImageBuildVersion}

aws:ResourceTag/${TagKey}

imageVersion arn:${Partition}:imagebuilder:${Region}:${Account}:image/${ImageName}/${ImageVersion}

aws:ResourceTag/${TagKey}

imageRecipe arn:${Partition}:imagebuilder:${Region}:${Account}:image-recipe/${ImageRecipeName}/${ImageRecipeVersion}

aws:ResourceTag/${TagKey}

containerRecipe arn:${Partition}:imagebuilder:${Region}:${Account}:container-recipe/${ContainerRecipeName}/${ContainerRecipeVersion}

aws:ResourceTag/${TagKey}

imagePipeline arn:${Partition}:imagebuilder:${Region}:${Account}:image-pipeline/${ImagePipelineName}

aws:ResourceTag/${TagKey}

infrastructureConfiguration arn:${Partition}:imagebuilder:${Region}:${Account}:infrastructure-configuration/${ResourceId}

aws:ResourceTag/${TagKey}

kmsKey arn:${Partition}:kms:${Region}:${Account}:key/${KeyId}

Amazon EC2 Image Builder 的条件键

Amazon EC2 Image Builder 定义以下可以在 IAM 策略的 Condition 元素中使用的条件键。您可以使用这些键进一步细化应用策略语句的条件。有关下表中各列的详细信息,请参阅 条件键表

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

条件键 描述 类型
aws:RequestTag/${TagKey} 根据在请求中是否具有标签键值对来筛选操作 字符串
aws:ResourceTag/${TagKey} 根据附加到资源的标签键值对来筛选操作 字符串
aws:TagKeys 根据在请求中是否具有标签键来筛选操作 字符串
imagebuilder:CreatedResourceTag/<key> 根据附加到映像生成器所创建的资源的标签键值对来筛选访问 字符串
imagebuilder:CreatedResourceTagKeys 根据在请求中是否具有标签键来筛选访问 字符串