将服务相关角色用于 EC2 映像生成器 - EC2 映像生成器
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

将服务相关角色用于 EC2 映像生成器

EC2 映像生成器 使用 AWS Identity and Access Management (IAM) 服务相关角色。服务相关角色是一种独特类型的 IAM 角色,它与 镜像生成器 直接相关。服务相关角色是由 镜像生成器 预定义的,并包含该服务代表您调用其他 AWS 服务所需的所有权限。

可以通过服务相关角色轻松设置 镜像生成器,因为您不必手动添加所需的权限。镜像生成器 定义其服务相关角色的权限,除非另行定义,否则,仅 镜像生成器 可以担任其角色。定义的权限包括信任策略和权限策略。不能将该权限策略附加到任何其他 IAM 实体。

有关支持服务相关角色的其他服务的信息,请参阅使用 IAM 的 AWS 服务并查找服务相关角色 列为 的服务。选择 Yes 与查看该服务的服务相关角色文档的链接。

镜像生成器 的服务相关角色权限

镜像生成器 使用名为 AWSServiceRoleForImageBuilder 的服务相关角色以允许 EC2 映像生成器 代表您访问 AWS 资源。

AWSServiceRoleForImageBuilder 服务相关角色信任以下服务以担任该角色:

  • imagebuilder.amazonaws.com

  • ssm.amazonaws.com

角色权限策略允许 镜像生成器 服务对指定的资源完成以下操作:

EC2

  • ec2:CancelExportTask

  • ec2:CopyImage

  • ec2:CreateImage

  • ec2:CreateLaunchTemplate

  • ec2:CreateTags

  • ec2:DeleteLaunchTemplate

  • ec2:DeregisterImage

  • ec2:DescribeImages

  • ec2:DescribeInstanceStatus

  • ec2:DescribeSubnets

  • ec2:DescribeTags

  • ec2:ModifyImageAttribute

  • ec2:RunInstances

  • ec2:StopInstances

  • ec2:TerminateInstances

IAM

  • iam:CreateServiceLinkedRole

License Manager

  • license-manager:UpdateLicenseSpecificationsForResource

SSM

  • ssm:AddTagsToResource

  • ssm:DescribeInstanceInformation

  • ssm:GetAutomationExecution

  • ssm:SendCommand

  • ssm:StartAutomationExecution

  • ssm:StopAutomationExecution

SNS

  • sns:Publish

您必须配置权限以允许 IAM 实体 (例如,用户、组或角色) 创建、编辑或删除服务相关角色。有关更多信息,请参阅 IAM 用户指南中的“服务相关角色权限”

为 EC2 映像生成器 创建服务相关角色

您无需手动创建服务相关角色。在 AWS 管理控制台、AWS CLI 或 AWS API 中创建第一个 镜像生成器 资源时,镜像生成器 将为您创建服务相关角色。

重要

如果您删除了此服务相关角色然后需要再次创建它,则可以使用相同的流程在您的账户中重新创建此角色。在创建第一个 EC2 映像生成器 资源时,镜像生成器 将再次为您创建服务相关角色。

您也可以使用 IAM 控制台为 EC2 映像生成器 使用案例创建服务相关角色。在 AWS CLI 或 AWS API 中,请使用 imagebuilder.amazonaws.com 服务名称创建一个服务相关角色。有关更多信息,请参阅 IAM 用户指南 中的创建服务相关角色。如果您删除了此服务相关角色,则可以使用此相同过程再次创建角色。

编辑 镜像生成器 的服务相关角色

可以使用 镜像生成器 控制台、AWS CLI 或 AWS API 更改 AWSServiceRoleForImageBuilder 服务相关角色的描述、信任策略或权限策略,包括添加其他策略。创建服务相关角色后,您将无法更改角色的名称,因为可能有多种实体引用该角色。不过,您只能使用 IAM、AWS CLI 或 API 编辑角色描述。有关更多信息,请参阅 IAM 用户指南 中的编辑服务相关角色

删除 镜像生成器 的服务相关角色

您可以使用 IAM 控制台、AWS CLI 或 AWS API 手动删除服务相关角色。为此,您必须先手动清除服务相关角色的资源,然后才能手动删除它。

注意

在尝试删除资源时,如果 镜像生成器 服务正在使用该角色,删除可能会失败。如果发生这种情况,则请等待几分钟后重试。

删除 AWSServiceRoleForImageBuilder 使用的 镜像生成器 资源

  1. 等待当前镜像生成过程完成,或者使用 cancel-image-creation API 明确取消这些生成。要在 镜像生成器 控制台上取消镜像生成,请为每个管道选择 Stop Pipeline (停止管道) 操作按钮。

  2. 使用 镜像生成器 控制台或 CLI 删除所有管道,或将所有镜像管道的生成计划更改为手动

使用 IAM 手动删除服务相关角色

使用 IAM 控制台、AWS CLI 或 AWS API 删除 AWSServiceRoleForImageBuilder 服务相关角色。有关更多信息,请参阅 IAM 用户指南 中的删除服务相关角色

EC2 映像生成器 服务相关角色支持的区域

镜像生成器 支持在提供服务相关角色的所有 AWS 区域中使用该服务。有关支持的 AWS 区域列表,请参阅 AWS 区域和终端节点