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

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

参考：

了解如何配置该服务。
查看适用于该服务的 API 操作列表。
了解如何使用 IAM 权限策略保护该服务及其资源。

主题

Amazon EC2 Image Builder 定义的操作
Amazon EC2 Image Builder 定义的资源类型
Amazon EC2 Image Builder 的条件键

Amazon EC2 Image Builder 定义的操作

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

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

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

操作	描述	访问级别	资源类型（* 为必需）	条件键	相关操作
CancelImageCreation	授予权限以取消映像创建	Write	image*
CreateComponent	授予权限以创建新组件	Write	component*		iam:CreateServiceLinkedRole imagebuilder:TagResource kms:Encrypt kms:GenerateDataKey kms:GenerateDataKeyWithoutPlaintext
			kmsKey
				aws:RequestTag/${TagKey} aws:TagKeys
CreateContainerRecipe	授予权限以创建新的容器配方	Write	containerRecipe*		ecr:DescribeImages ecr:DescribeRepositories iam:CreateServiceLinkedRole imagebuilder:GetComponent imagebuilder:GetImage imagebuilder:TagResource kms:Encrypt kms:GenerateDataKey kms:GenerateDataKeyWithoutPlaintext
CreateContainerRecipe	授予权限以创建新的容器配方	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateDistributionConfiguration	授予权限以创建新的分配配置	Write	distributionConfiguration*		iam:CreateServiceLinkedRole imagebuilder:TagResource
CreateDistributionConfiguration	授予权限以创建新的分配配置	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateImage	授予权限以创建新的映像	Write	image*		iam:CreateServiceLinkedRole imagebuilder:GetContainerRecipe imagebuilder:GetDistributionConfiguration imagebuilder:GetImageRecipe imagebuilder:GetInfrastructureConfiguration imagebuilder:TagResource
CreateImage	授予权限以创建新的映像	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateImagePipeline	授予权限以创建新的映像管道	Write	imagePipeline*		iam:CreateServiceLinkedRole imagebuilder:GetContainerRecipe imagebuilder:GetImageRecipe imagebuilder:TagResource
CreateImagePipeline	授予权限以创建新的映像管道	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateImageRecipe	授予权限以创建新的映像配方	Write	imageRecipe*		ec2:DescribeImages iam:CreateServiceLinkedRole imagebuilder:GetComponent imagebuilder:GetImage imagebuilder:TagResource
CreateImageRecipe	授予权限以创建新的映像配方	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateInfrastructureConfiguration	授予权限以创建新的基础设施配置	Write	infrastructureConfiguration*		iam:CreateServiceLinkedRole iam:PassRole imagebuilder:TagResource sns:Publish
CreateInfrastructureConfiguration	授予权限以创建新的基础设施配置	Write		aws:RequestTag/${TagKey} aws:TagKeys imagebuilder:CreatedResourceTagKeys imagebuilder:CreatedResourceTag/<key> imagebuilder:Ec2MetadataHttpTokens imagebuilder:StatusTopicArn
DeleteComponent	授予删除组件的权限	Write	component*
DeleteContainerRecipe	授予删除容器配方的权限	Write	containerRecipe*
DeleteDistributionConfiguration	授予权限以删除分配配置	Write	distributionConfiguration*
DeleteImage	授予权限以删除映像	Write	image*
DeleteImagePipeline	授予权限以删除映像管道	Write	imagePipeline*
DeleteImageRecipe	授予权限以删除映像配方	Write	imageRecipe*
DeleteInfrastructureConfiguration	授予权限以删除基础设施配置	Write	infrastructureConfiguration*
GetComponent	授予权限以查看有关组件的详细信息	Read	component*		kms:Decrypt
GetComponentPolicy	授予权限以查看与组件关联的资源策略	Read	component*
GetContainerRecipe	授予权限以查看有关容器配方的详细信息	Read	containerRecipe*
GetContainerRecipePolicy	授予权限以查看与容器配方关联的资源策略	Read	containerRecipe*
GetDistributionConfiguration	授予权限以查看有关分配配置的详细信息	Read	distributionConfiguration*
GetImage	授予权限以查看有关映像的详细信息	Read	image*
GetImage	授予权限以查看有关映像的详细信息	Read		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
ImportVmImage	授予导入镜像的权限	写入	image*		ec2:DescribeImportImageTasks iam:CreateServiceLinkedRole
ImportVmImage	授予导入镜像的权限	写入		aws:RequestTag/${TagKey} aws:TagKeys
ListComponentBuildVersions	授予权限以列出您账户中的组件内部版本	List	componentVersion*
ListComponents	授予权限以列出您的账户拥有或与之共享的组件版本	List
ListContainerRecipes	授予权限以列出您账户拥有或与之共享的容器配方	List
ListDistributionConfigurations	授予权限以列出您账户中的分配配置	List
ListImageBuildVersions	授予权限以列出您账户中的映像内部版本	List	imageVersion*
ListImagePackages	授予权限以返回指定映像上安装的软件包列表	List	image*
ListImagePackages	授予权限以返回指定映像上安装的软件包列表	List		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	授予权限以设置与组件关联的资源策略	Permissions management	component*
PutContainerRecipePolicy	授予权限以设置与容器配方关联的资源策略	Permissions management	containerRecipe*
PutImagePolicy	授予权限以设置与映像关联的资源策略	Permissions management	image*
PutImageRecipePolicy	授予权限以设置与映像配方关联的资源策略	Permissions management	imageRecipe*
StartImagePipelineExecution	授予权限以从管道创建新的映像	Write	imagePipeline*		iam:CreateServiceLinkedRole imagebuilder:GetImagePipeline
TagResource	授予权限以标记 Image Builder 资源	Tagging	component
			containerRecipe
			distributionConfiguration
			image
			imagePipeline
			imageRecipe
			infrastructureConfiguration
				aws:TagKeys aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey}
UntagResource	授予权限以取消标记 Image Builder 资源	Tagging	component
			containerRecipe
			distributionConfiguration
			image
			imagePipeline
			imageRecipe
			infrastructureConfiguration
				aws:ResourceTag/${TagKey} aws:TagKeys
UpdateDistributionConfiguration	授予权限以更新现有分配配置	Write	distributionConfiguration*
UpdateImagePipeline	授予权限以更新现有映像管道	Write	imagePipeline*
UpdateInfrastructureConfiguration	授予权限以更新现有基础设施配置	Write	infrastructureConfiguration*		iam:PassRole sns:Publish
UpdateInfrastructureConfiguration	授予权限以更新现有基础设施配置	Write		aws:ResourceTag/${TagKey} imagebuilder:CreatedResourceTagKeys imagebuilder:CreatedResourceTag/<key> imagebuilder:Ec2MetadataHttpTokens imagebuilder:StatusTopicArn

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>	根据附加到 Image Builder 所创建的资源的标签键值对来筛选访问	字符串
imagebuilder:CreatedResourceTagKeys	根据在请求中是否具有标签键来筛选访问	字符串数组
imagebuilder:Ec2MetadataHttpTokens	按请求中指定的 EC2 实例元数据 HTTP Token Requirement 筛选访问权限	字符串
imagebuilder:StatusTopicArn	按将发送终端状态通知的请求中的 SNS Topic Arn 筛选访问权限	字符串

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

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

Amazon EC2 Auto Scaling

Amazon Elastic Beanstalk