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

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

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

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

参考:

Amazon EC2 Image Builder 定义的操作

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

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

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

注意

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

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

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

image*

CancelLifecycleExecution 授予取消生命周期执行的权限 写入

lifecycleExecution*

CreateComponent 授予权限以创建新组件 Write

component*

aws:RequestTag/${TagKey}

aws:TagKeys

iam:CreateServiceLinkedRole

imagebuilder:TagResource

kms:Encrypt

kms:GenerateDataKey

kms:GenerateDataKeyWithoutPlaintext

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

containerRecipe*

aws:RequestTag/${TagKey}

aws:TagKeys

ecr:DescribeImages

ecr:DescribeRepositories

iam:CreateServiceLinkedRole

imagebuilder:GetComponent

imagebuilder:GetImage

imagebuilder:TagResource

kms:Encrypt

kms:GenerateDataKey

kms:GenerateDataKeyWithoutPlaintext

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

distributionConfiguration*

aws:RequestTag/${TagKey}

aws:TagKeys

iam:CreateServiceLinkedRole

imagebuilder:TagResource

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

image*

aws:RequestTag/${TagKey}

aws:TagKeys

iam:CreateServiceLinkedRole

iam:PassRole

imagebuilder:GetContainerRecipe

imagebuilder:GetDistributionConfiguration

imagebuilder:GetImageRecipe

imagebuilder:GetInfrastructureConfiguration

imagebuilder:GetWorkflow

imagebuilder:TagResource

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

imagePipeline*

aws:RequestTag/${TagKey}

aws:TagKeys

iam:CreateServiceLinkedRole

iam:PassRole

imagebuilder:GetContainerRecipe

imagebuilder:GetDistributionConfiguration

imagebuilder:GetImageRecipe

imagebuilder:GetInfrastructureConfiguration

imagebuilder:GetWorkflow

imagebuilder:TagResource

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

imageRecipe*

aws:RequestTag/${TagKey}

aws:TagKeys

ec2:DescribeImages

iam:CreateServiceLinkedRole

imagebuilder:GetComponent

imagebuilder:GetImage

imagebuilder:TagResource

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

infrastructureConfiguration*

aws:RequestTag/${TagKey}

aws:TagKeys

imagebuilder:CreatedResourceTagKeys

imagebuilder:CreatedResourceTag/<key>

imagebuilder:Ec2MetadataHttpTokens

imagebuilder:StatusTopicArn

iam:CreateServiceLinkedRole

iam:PassRole

imagebuilder:TagResource

sns:Publish

CreateLifecyclePolicy 授予创建新生命周期策略的权限 写入

lifecyclePolicy*

aws:RequestTag/${TagKey}

aws:TagKeys

imagebuilder:LifecyclePolicyResourceType

iam:PassRole

imagebuilder:TagResource

CreateWorkflow 授予创建新工作流的权限 写入

workflow*

aws:RequestTag/${TagKey}

aws:TagKeys

imagebuilder:TagResource

kms:Encrypt

kms:GenerateDataKey

kms:GenerateDataKeyWithoutPlaintext

s3:GetObject

s3:ListBucket

DeleteComponent 授予删除组件的权限 Write

component*

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

containerRecipe*

DeleteDistributionConfiguration 授予权限以删除分配配置 Write

distributionConfiguration*

DeleteImage 授予权限以删除映像 Write

image*

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

imagePipeline*

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

imageRecipe*

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

infrastructureConfiguration*

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

lifecyclePolicy*

DeleteWorkflow 授予权限以删除工作流程 写入

workflow*

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 授予权限以查看有关基础设施配置的详细信息 读取

infrastructureConfiguration*

GetLifecycleExecution 授予查看生命周期执行详细信息的权限 读取

lifecycleExecution*

GetLifecyclePolicy 授予查看生命周期策略详细信息的权限 读取

lifecyclePolicy*

GetWorkflow 授予查看工作流详细信息的权限 读取

workflow*

kms:Decrypt

GetWorkflowExecution 授予查看工作流程执行详细信息的权限 读取

workflowExecution*

GetWorkflowStepExecution 授予查看工作流程步骤执行详细信息的权限 读取

workflowStepExecution*

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

component*

aws:RequestTag/${TagKey}

aws:TagKeys

iam:CreateServiceLinkedRole

imagebuilder:TagResource

kms:Encrypt

kms:GenerateDataKey

kms:GenerateDataKeyWithoutPlaintext

ImportVmImage 授予导入镜像的权限 写入

image*

aws:RequestTag/${TagKey}

aws:TagKeys

ec2:DescribeImportImageTasks

iam:CreateServiceLinkedRole

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

componentVersion*

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

imageVersion*

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

image*

aws:ResourceTag/${TagKey}

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

imagePipeline*

ListImagePipelines 授予权限以列出您账户中的映像管道 List
ListImageRecipes 授予权限以列出您账户拥有或与之共享的映像配方 列出
ListImageScanFindingAggregations 授予权限以列出您账户中的映像扫描结果的聚合 列出

image

imagePipeline

ListImageScanFindings 授予权限以列出您账户中的映像的扫描结果 列出

image

inspector2:ListFindings

imagePipeline

ListImages 授予权限以列出您账户拥有或与之共享的映像版本 List
ListInfrastructureConfigurations 授予权限以列出您账户中的基础设施配置 列出
ListLifecycleExecutionResources 授予列出指定生命周期执行的资源的权限 列出

lifecycleExecution*

ListLifecycleExecutions 授予列出指定资源的生命周期执行的权限 列出

image

lifecyclePolicy

ListLifecyclePolicies 授予列出您账户中的生命周期策略的权限 列出
ListTagsForResource 授予权限以列出 Image Builder 资源的标签 读取

component

aws:ResourceTag/${TagKey}

containerRecipe

aws:ResourceTag/${TagKey}

distributionConfiguration

aws:ResourceTag/${TagKey}

image

aws:ResourceTag/${TagKey}

imagePipeline

aws:ResourceTag/${TagKey}

imageRecipe

aws:ResourceTag/${TagKey}

infrastructureConfiguration

aws:ResourceTag/${TagKey}

lifecyclePolicy

aws:ResourceTag/${TagKey}

workflow

aws:ResourceTag/${TagKey}

ListWaitingWorkflowSteps 授予列出调用方账户的等待工作流步骤的权限 列出
ListWorkflowBuildVersions 授予列出您账户中的工作流内部版本的权限 列出

workflowVersion*

ListWorkflowExecutions 授予权限以列出指定映像的工作流程执行情况 列出

image*

ListWorkflowStepExecutions 授予权限以列出指定工作流程的步骤执行情况 列出

workflowExecution*

ListWorkflows 授予列出您账户拥有或与之共享的工作流版本的权限 列出
PutComponentPolicy 授予权限以设置与组件关联的资源策略 Permissions management

component*

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

containerRecipe*

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

image*

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

imageRecipe*

SendWorkflowStepAction 授予将操作发送到工作流步骤的权限 写入

image*

workflowStepExecution*

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

imagePipeline*

iam:CreateServiceLinkedRole

imagebuilder:GetImagePipeline

StartResourceStateUpdate 授予启动指定资源的状态更新的权限 写入

image*

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

component

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

containerRecipe

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

distributionConfiguration

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

image

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

imagePipeline

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

imageRecipe

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

infrastructureConfiguration

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

lifecyclePolicy

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

workflow

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

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

component

aws:ResourceTag/${TagKey}

aws:TagKeys

containerRecipe

aws:ResourceTag/${TagKey}

aws:TagKeys

distributionConfiguration

aws:ResourceTag/${TagKey}

aws:TagKeys

image

aws:ResourceTag/${TagKey}

aws:TagKeys

imagePipeline

aws:ResourceTag/${TagKey}

aws:TagKeys

imageRecipe

aws:ResourceTag/${TagKey}

aws:TagKeys

infrastructureConfiguration

aws:ResourceTag/${TagKey}

aws:TagKeys

lifecyclePolicy

aws:ResourceTag/${TagKey}

aws:TagKeys

workflow

aws:ResourceTag/${TagKey}

aws:TagKeys

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

distributionConfiguration*

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

imagePipeline*

iam:CreateServiceLinkedRole

iam:PassRole

imagebuilder:GetContainerRecipe

imagebuilder:GetDistributionConfiguration

imagebuilder:GetImageRecipe

imagebuilder:GetInfrastructureConfiguration

imagebuilder:GetWorkflow

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

infrastructureConfiguration*

aws:ResourceTag/${TagKey}

imagebuilder:CreatedResourceTagKeys

imagebuilder:CreatedResourceTag/<key>

imagebuilder:Ec2MetadataHttpTokens

imagebuilder:StatusTopicArn

iam:PassRole

sns:Publish

UpdateLifecyclePolicy 授予更新现有生命周期策略的权限 写入

lifecyclePolicy*

imagebuilder:LifecyclePolicyResourceType

iam:PassRole

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}
lifecycleExecution arn:${Partition}:imagebuilder:${Region}:${Account}:lifecycle-execution/${LifecycleExecutionId}
lifecyclePolicy arn:${Partition}:imagebuilder:${Region}:${Account}:lifecycle-policy/${LifecyclePolicyName}

aws:ResourceTag/${TagKey}

workflow arn:${Partition}:imagebuilder:${Region}:${Account}:workflow/${WorkflowType}/${WorkflowName}/${WorkflowVersion}/${WorkflowBuildVersion}

aws:ResourceTag/${TagKey}

workflowVersion arn:${Partition}:imagebuilder:${Region}:${Account}:workflow/${WorkflowType}/${WorkflowName}/${WorkflowVersion}

aws:ResourceTag/${TagKey}

workflowExecution arn:${Partition}:imagebuilder:${Region}:${Account}:workflow-execution/${WorkflowExecutionId}
workflowStepExecution arn:${Partition}:imagebuilder:${Region}:${Account}:workflow-step-execution/${WorkflowStepExecutionId}

Amazon EC2 Image Builder 的条件键

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

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

条件键 描述 类型
aws:RequestTag/${TagKey} 根据在请求中是否具有标签键值对来筛选访问权限 String
aws:ResourceTag/${TagKey} 按附加到资源的标签键值对筛选操作 String
aws:TagKeys 根据在请求中是否具有标签键来筛选访问 ArrayOfString
imagebuilder:CreatedResourceTag/<key> 根据附加到 Image Builder 所创建的资源的标签键值对来筛选访问 字符串
imagebuilder:CreatedResourceTagKeys 根据在请求中是否具有标签键来筛选访问 ArrayOfString
imagebuilder:Ec2MetadataHttpTokens 按请求中指定的 EC2 实例元数据 HTTP Token Requirement 筛选访问权限 String
imagebuilder:LifecyclePolicyResourceType 按请求中指定的生命周期策略资源类型筛选访问权限 String
imagebuilder:StatusTopicArn 按将发送终端状态通知的请求中的 SNS Topic Arn 筛选访问权限 ARN