Amazon EC2 Image Builder 的操作、资源和条件键
Amazon EC2 Image Builder（服务前缀：imagebuilder）提供以下服务特定的资源、操作和条件上下文键以在 IAM 权限策略中使用。
参考：
Amazon EC2 Image Builder 定义的操作
您可以在 IAM policy 语句的 Action 元素中指定以下操作。可以使用策略授予在 Amazon 中执行操作的权限。您在策略中使用一项操作时，通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下，单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。
操作表的资源类型列指示每项操作是否支持资源级权限。如果该列没有任何值，您必须在策略语句的 Resource 元素中指定策略应用的所有资源（“*”）。通过在 IAM policy 中使用条件来筛选访问权限，以控制是否可以在资源或请求中使用特定标签键。如果操作具有一个或多个必需资源，则调用方必须具有使用这些资源来使用该操作的权限。必需资源在表中以星号 (*) 表示。如果您在 IAM policy 中使用 Resource 元素限制资源访问权限，则必须为每种必需的资源类型添加 ARN 或模式。某些操作支持多种资源类型。如果资源类型是可选的（未指示为必需），则可以选择使用一种可选资源类型。
操作表的条件键列包括可以在策略语句的 Condition 元素中指定的键。有关与服务资源关联的条件键的更多信息，请参阅资源类型表的条件键列。
有关下表中各列的详细信息，请参阅操作表。
| 操作 | 描述 | 访问级别 | 资源类型（* 为必需） | 条件键 | 相关操作 |
|---|---|---|---|---|---|
| CancelImageCreation | 授予权限以取消映像创建 | Write | |||
| CreateComponent | 授予权限以创建新组件 | Write |
iam:CreateServiceLinkedRole imagebuilder:TagResource kms:Encrypt kms:GenerateDataKey kms:GenerateDataKeyWithoutPlaintext |
||
| CreateContainerRecipe | 授予权限以创建新的容器配方 | Write |
ecr:DescribeImages ecr:DescribeRepositories iam:CreateServiceLinkedRole imagebuilder:GetComponent imagebuilder:GetImage imagebuilder:TagResource kms:Encrypt kms:GenerateDataKey kms:GenerateDataKeyWithoutPlaintext |
||
| CreateDistributionConfiguration | 授予权限以创建新的分配配置 | Write |
iam:CreateServiceLinkedRole imagebuilder:TagResource |
||
| CreateImage | 授予权限以创建新的映像 | Write |
iam:CreateServiceLinkedRole imagebuilder:GetContainerRecipe imagebuilder:GetDistributionConfiguration imagebuilder:GetImageRecipe imagebuilder:GetInfrastructureConfiguration imagebuilder:TagResource |
||
| CreateImagePipeline | 授予权限以创建新的映像管道 | Write |
iam:CreateServiceLinkedRole imagebuilder:GetContainerRecipe imagebuilder:GetImageRecipe imagebuilder:TagResource |
||
| CreateImageRecipe | 授予权限以创建新的映像配方 | Write |
ec2:DescribeImages iam:CreateServiceLinkedRole imagebuilder:GetComponent imagebuilder:GetImage imagebuilder:TagResource |
||
| CreateInfrastructureConfiguration | 授予权限以创建新的基础设施配置 | Write |
iam:CreateServiceLinkedRole iam:PassRole imagebuilder:TagResource sns:Publish |
||
|
imagebuilder:CreatedResourceTagKeys imagebuilder:CreatedResourceTag/<key> |
|||||
| DeleteComponent | 授予删除组件的权限 | Write | |||
| DeleteContainerRecipe | 授予删除容器配方的权限 | Write | |||
| DeleteDistributionConfiguration | 授予权限以删除分配配置 | Write | |||
| DeleteImage | 授予权限以删除映像 | Write | |||
| DeleteImagePipeline | 授予权限以删除映像管道 | Write | |||
| DeleteImageRecipe | 授予权限以删除映像配方 | Write | |||
| DeleteInfrastructureConfiguration | 授予权限以删除基础设施配置 | Write | |||
| GetComponent | 授予权限以查看有关组件的详细信息 | Read |
kms:Decrypt |
||
| GetComponentPolicy | 授予权限以查看与组件关联的资源策略 | Read | |||
| GetContainerRecipe | 授予权限以查看有关容器配方的详细信息 | Read | |||
| GetContainerRecipePolicy | 授予权限以查看与容器配方关联的资源策略 | Read | |||
| GetDistributionConfiguration | 授予权限以查看有关分配配置的详细信息 | Read | |||
| GetImage | 授予权限以查看有关映像的详细信息 | Read | |||
| GetImagePipeline | 授予权限以查看有关映像管道的详细信息 | Read | |||
| GetImagePolicy | 授予权限以查看与映像关联的资源策略 | Read | |||
| GetImageRecipe | 授予权限以查看有关映像配方的详细信息 | Read | |||
| GetImageRecipePolicy | 授予权限以查看与映像配方关联的资源策略 | Read | |||
| GetInfrastructureConfiguration | 授予权限以查看有关基础设施配置的详细信息 | Read | |||
| GetWorkflowExecution | 授予查看工作流程执行详细信息的权限 | Read | |||
| GetWorkflowStepExecution | 授予查看工作流程步骤执行详细信息的权限 | Read | |||
| ImportComponent | 授予权限以导入新组件 | Write |
iam:CreateServiceLinkedRole imagebuilder:TagResource kms:Encrypt kms:GenerateDataKey kms:GenerateDataKeyWithoutPlaintext |
||
| ImportVmImage | 授予导入镜像的权限 | Write |
ec2:DescribeImportImageTasks iam:CreateServiceLinkedRole |
||
| ListComponentBuildVersions | 授予权限以列出您账户中的组件内部版本 | List | |||
| ListComponents | 授予权限以列出您的账户拥有或与之共享的组件版本 | List | |||
| ListContainerRecipes | 授予权限以列出您账户拥有或与之共享的容器配方 | List | |||
| ListDistributionConfigurations | 授予权限以列出您账户中的分配配置 | List | |||
| ListImageBuildVersions | 授予权限以列出您账户中的映像内部版本 | List | |||
| ListImagePackages | 授予权限以返回指定映像上安装的软件包列表 | List | |||
| ListImagePipelineImages | 授予权限以返回由指定管道创建的映像的列表 | List | |||
| ListImagePipelines | 授予权限以列出您账户中的映像管道 | List | |||
| ListImageRecipes | 授予权限以列出您账户拥有或与之共享的映像配方 | List | |||
| ListImageScanFindingAggregations | 授予权限以列出您账户中的映像扫描结果的聚合 | List | |||
| ListImageScanFindings | 授予权限以列出您账户中的映像的扫描结果 | List |
inspector2:ListFindings |
||
| ListImages | 授予权限以列出您账户拥有或与之共享的映像版本 | List | |||
| ListInfrastructureConfigurations | 授予权限以列出您账户中的基础设施配置 | List | |||
| ListTagsForResource | 授予权限以列出 Image Builder 资源的标签 | Read | |||
| ListWorkflowExecutions | 授予权限以列出指定映像的工作流程执行情况 | List | |||
| ListWorkflowStepExecutions | 授予权限以列出指定工作流程的步骤执行情况 | List | |||
| PutComponentPolicy | 授予权限以设置与组件关联的资源策略 | Permissions management | |||
| PutContainerRecipePolicy | 授予权限以设置与容器配方关联的资源策略 | Permissions management | |||
| PutImagePolicy | 授予权限以设置与映像关联的资源策略 | Permissions management | |||
| PutImageRecipePolicy | 授予权限以设置与映像配方关联的资源策略 | Permissions management | |||
| StartImagePipelineExecution | 授予权限以从管道创建新的映像 | Write |
iam:CreateServiceLinkedRole imagebuilder:GetImagePipeline |
||
| TagResource | 授予权限以标记 Image Builder 资源 | Tagging | |||
| UntagResource | 授予权限以取消标记 Image Builder 资源 | Tagging | |||
| UpdateDistributionConfiguration | 授予权限以更新现有分配配置 | Write | |||
| UpdateImagePipeline | 授予权限以更新现有映像管道 | Write | |||
| UpdateInfrastructureConfiguration | 授予权限以更新现有基础设施配置 | Write |
iam:PassRole sns:Publish |
||
|
imagebuilder:CreatedResourceTagKeys imagebuilder:CreatedResourceTag/<key> |
Amazon EC2 Image Builder 定义的资源类型
以下资源类型是由该服务定义的，可以在 IAM 权限策略语句的 Resource 元素中使用这些资源类型。操作表中的每个操作指定了可以使用该操作指定的资源类型。您也可以在策略中包含条件键，从而定义资源类型。这些键显示在资源类型表的最后一列。有关下表中各列的详细信息，请参阅资源类型表。
| 资源类型 | ARN | 条件键 |
|---|---|---|
| component |
arn:${Partition}:imagebuilder:${Region}:${Account}:component/${ComponentName}/${ComponentVersion}/${ComponentBuildVersion}
|
|
| componentVersion |
arn:${Partition}:imagebuilder:${Region}:${Account}:component/${ComponentName}/${ComponentVersion}
|
|
| distributionConfiguration |
arn:${Partition}:imagebuilder:${Region}:${Account}:distribution-configuration/${DistributionConfigurationName}
|
|
| image |
arn:${Partition}:imagebuilder:${Region}:${Account}:image/${ImageName}/${ImageVersion}/${ImageBuildVersion}
|
|
| imageVersion |
arn:${Partition}:imagebuilder:${Region}:${Account}:image/${ImageName}/${ImageVersion}
|
|
| imageRecipe |
arn:${Partition}:imagebuilder:${Region}:${Account}:image-recipe/${ImageRecipeName}/${ImageRecipeVersion}
|
|
| containerRecipe |
arn:${Partition}:imagebuilder:${Region}:${Account}:container-recipe/${ContainerRecipeName}/${ContainerRecipeVersion}
|
|
| imagePipeline |
arn:${Partition}:imagebuilder:${Region}:${Account}:image-pipeline/${ImagePipelineName}
|
|
| infrastructureConfiguration |
arn:${Partition}:imagebuilder:${Region}:${Account}:infrastructure-configuration/${ResourceId}
|
|
| kmsKey |
arn:${Partition}:kms:${Region}:${Account}:key/${KeyId}
|
|
| 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} | 根据在请求中是否具有标签键值对来筛选访问权限 | 字符串 |
| aws:ResourceTag/${TagKey} | 按附加到资源的标签键值对筛选操作 | 字符串 |
| aws:TagKeys | 根据在请求中是否具有标签键来筛选访问 | 字符串数组 |
| imagebuilder:CreatedResourceTag/<key> | 根据附加到 Image Builder 所创建的资源的标签键值对来筛选访问 | 字符串 |
| imagebuilder:CreatedResourceTagKeys | 根据在请求中是否具有标签键来筛选访问 | 字符串数组 |
| imagebuilder:Ec2MetadataHttpTokens | 按请求中指定的 EC2 实例元数据 HTTP Token Requirement 筛选访问权限 | 字符串 |
| imagebuilder:StatusTopicArn | 按将发送终端状态通知的请求中的 SNS Topic Arn 筛选访问权限 | 字符串 |