AWS Systems Manager
用户指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS-AttachIAMToInstance

描述

将 AWS Identity and Access Management (IAM) 角色附加到一个托管实例。

文档类型

Automation

所有者

Amazon

平台

Windows、Linux

参数

  • AutomationAssumeRole

    类型:字符串

    说明:(可选)允许 Automation 代表您执行操作的角色的 ARN。

  • 实例 ID

    类型:字符串

    说明:(必需)要为其分配 IAM 角色的实例的 ID。

  • RoleName

    类型:字符串

    说明:(必需)要添加到托管实例的 IAM 角色名称。

  • ForceReplace

    类型:布尔值

    说明:(可选)指定是否替换现有 IAM 配置文件的标记。

    默认值:True

示例

启动 Automation

aws ssm start-automation-execution --document-name AWS-AttachIAMToInstance --parameters parameters

检索执行输出

aws ssm get-automation-execution --automation-execution-id EXECUTIONID --output text --query 'AutomationExecution.Output'

文档步骤

  1. aws:executeAwsApi - DescribeInstanceProfile - 查找附加到 Amazon EC2 实例的 IAM 实例配置文件。

  2. aws:branch - CheckInstanceProfileAssociations - 检查附加到 Amazon EC2 实例的 IAM 实例配置文件。

    1. 如果附加了 IAM 实例配置文件并将 ForceReplace 设置为 true

      1. aws:executeAwsApi - DisassociateIamInstanceProfile - 将 IAM 实例配置文件与 Amazon EC2 实例取消关联。

    2. aws:executeAwsApi - ListInstanceProfilesForRole - 列出提供的 IAM 角色的实例配置文件。

    3. aws:branch - CheckInstanceProfileCreated - 检查提供的 IAM 角色是否具有关联的实例配置文件。

      1. 如果 IAM 角色具有关联的实例配置文件:

        1. aws:executeAwsApi - AttachIAMProfileToInstance - 将 IAM 实例配置文件角色附加到 Amazon EC2 实例。

      1. 如果 IAM 角色没有关联的实例配置文件:

        1. aws:executeAwsApi - CreateInstanceProfileForRole - 为指定的 IAM 角色创建一个实例配置文件角色。

        2. aws:executeAwsApi - AddRoleToInstanceProfile - 将实例配置文件角色附加到指定的 IAM 角色。

        3. aws:executeAwsApi - GetInstanceProfile - 获取指定的 IAM 角色的实例配置文件数据。

        4. aws:executeAwsApi - AttachIAMProfileToInstanceWithRetry - 将 IAM 实例配置文件角色附加到 Amazon EC2 实例。

输出

AttachIAMProfileToInstanceWithRetry.AssociationId

GetInstanceProfile.InstanceProfileName

GetInstanceProfile.InstanceProfileArn

AttachIAMProfileToInstance.AssociationId

ListInstanceProfilesForRole.InstanceProfileName

ListInstanceProfilesForRole.InstanceProfileArn