AWS Identity and Access Management

用户指南

AWS 文档 » AWS Identity and Access Management » 用户指南 » 身份 (用户、组和角色) » IAM 角色 » 管理 IAM 角色 » 修改角色

修改角色

您可以使用以下方法更改或修改 IAM 中的角色：

您可以使用 AWS 管理控制台、AWS 命令行工具、Windows PowerShell 工具 或 IAM API 来进行这些更改。

查看角色访问

在更改角色的权限之前，您应查看其最近的服务级别活动。这非常重要，因为您不想删除使用它的委托人（个人或应用程序）的访问权限。有关查看上次访问的服务相关数据的更多信息，请参阅使用上次访问的服务数据优化权限。

修改角色 (控制台)

可以使用 AWS 管理控制台修改角色。

更改谁可担任角色（控制台）

1. 登录 AWS 管理控制台 并通过以下网址打开 IAM 控制台 https://console.amazonaws.cn/iam/。

2. 在 IAM 控制台的导航窗格中，选择 Roles。

3. 在您的账户的角色列表中，选择要修改的角色的名称。

4. 选择 Trust relationships 选项卡，然后选择 Edit trust relationship。

5. 根据需要编辑信任策略。要添加其他可担任角色的委托人，请在 Principal 元素中指定他们。例如，以下策略代码段说明了如何在 Principal 元素中引用两个 AWS 账户：

   "Principal": {
     "AWS": [
       "arn:aws-cn:iam::111122223333:root",
       "arn:aws-cn:iam::444455556666:root"
     ]
   },

   如果您指定其他账户中的委托人，将账户添加到角色的信任策略只是建立跨账户信任关系工作的一半而已。默认情况下，受信任账户中的任何用户均无法担任角色。新的受信任账户的管理员必须授予用户担任角色的权限。为此，管理员必须创建或编辑附加到用户以允许该用户访问 sts:AssumeRole 操作的策略。有关更多信息，请参阅以下过程或向用户授予切换角色的权限。

   以下策略代码段说明了如何在 Principal 元素中引用两个 AWS 服务：

   "Principal": {
     "Service": [
       "opsworks.amazonaws.com.cn",
       "ec2.amazonaws.com.cn"
     ]
   },

6. 在编辑完信任策略后，请选择更新信任策略以保存所做更改。

   有关策略结构和语法的更多信息，请参阅策略和权限和IAM JSON 策略元素参考。

允许受信任外部账户中的用户使用角色 (控制台)

有关此过程的更多详细信息，请参阅向用户授予切换角色的权限。

1. 登录受信任外部 AWS 账户。

2. 确定将权限附加到用户还是附加到组。在 IAM 控制台的导航窗格中，相应选择 Users 或 Groups。

3. 选择您要向其授予访问权限的用户或组的名称，然后选择 Permissions 选项卡。

4. 执行以下任一操作：

   • 要编辑某个客户 托管策略，请选择该策略的名称，选择编辑策略，然后选择 JSON 选项卡。您不能编辑 AWS 托管策略。AWS 托管策略随 AWS 图标 ( ) 一起显示。有关 AWS 托管策略与客户托管策略之间的差别的更多信息，请参阅托管策略与内联策略。

   • 要编辑某个内联策略，请选择该策略名称旁边的箭头，然后选择 Edit policy。

5. 在策略编辑器中，添加一个新的 Statement 元素，指定以下内容：

   {
     "Effect": "Allow",
     "Action": "sts:AssumeRole",
     "Resource": "arn:aws-cn:iam::ACCOUNT-ID:role/ROLE-NAME"
   }

   将语句中的 ARN 替换为用户可担任的角色的 ARN。

6. 按照屏幕上的提示完成策略的编辑。

更改角色允许的权限 (控制台)

1. 通过以下网址打开 IAM 控制台：https://console.amazonaws.cn/iam/。

2. 在 IAM 控制台的导航窗格中，选择 Roles。

3. 选择要修改的角色的名称，然后选择权限选项卡。

4. 执行以下任一操作：

   • 要编辑某个现有客户托管策略，请选择该策略的名称，然后选择 Edit policy。

     注意

     您无法编辑 AWS 托管策略。AWS 托管策略随 AWS 图标 ( ) 一起显示。有关 AWS 托管策略与客户托管策略之间的差别的更多信息，请参阅托管策略与内联策略。

   • 要将现有的托管策略附加到角色，请选择添加权限。

   • 要编辑某个现有的内联策略，请选择该策略名称旁边的箭头，然后选择 Edit Policy。

   • 要嵌入新内联策略，请选择 Add inline policy。

更改角色的描述 (控制台)

1. 登录 AWS 管理控制台 并通过以下网址打开 IAM 控制台 https://console.amazonaws.cn/iam/。

2. 在 IAM 控制台的导航窗格中，选择 Roles。

3. 选择要修改的角色的名称。

4. 在 Role description 旁边 (最右侧)，选择 Edit。

5. 在框中键入新描述，然后选择 Save。

更改使用 AWS CLI 或 API 担任的角色的最大会话持续时间设置（控制台）

1. 登录 AWS 管理控制台 并通过以下网址打开 IAM 控制台 https://console.amazonaws.cn/iam/。

2. 在 IAM 控制台的导航窗格中，选择 Roles。

3. 选择要修改的角色的名称。

4. 在最大 CLI/API 会话持续时间旁边，选择一个值。或者，选择自定义持续时间，然后键入一个值 (以秒为单位)。

5. 选择 Save。

   在某个人下次担任该角色后，您所做的更改才会生效。要了解如何撤销该角色的现有会话，请参阅撤消 IAM 角色临时安全凭证。

更改用于设置角色的权限边界的策略

1. 登录 AWS 管理控制台 并通过以下网址打开 IAM 控制台 https://console.amazonaws.cn/iam/。

2. 在导航窗格中，选择 Roles。

3. 选择要更改其权限边界的角色的名称。

4. 选择 Permissions 选项卡。如有必要，打开权限边界部分，然后选择更改边界。

5. 选择要用于权限边界的策略。

6. 选择更改边界。

   在某个人下次担任该角色后，您所做的更改才会生效。

修改角色 (AWS CLI)

可以使用 AWS Command Line Interface 修改角色。

更改谁可担任角色 (AWS CLI)

1. （可选）如果不知道要修改的角色的名称，请运行以下命令以列出账户中的角色：

   • aws iam list-roles

2. （可选）要查看角色当前的信任策略，请运行以下命令：

   • aws iam get-role

3. 要修改可访问角色的受信任委托人，请创建带有已更新信任策略的文本文件。您可以使用任何文本编辑器构件策略。

   例如，以下信任策略说明了如何在 Principal 元素中引用两个 AWS 账户。这允许两个单独的 AWS 账户中的用户担任此角色。

   {
       "Version": "2012-10-17",
       "Statement": {
           "Effect": "Allow",
           "Principal": {"AWS": [
               "arn:aws:iam::111122223333:root",
               "arn:aws:iam::444455556666:root"
           ]},
           "Action": "sts:AssumeRole"
       }
   }

   如果您指定其他账户中的委托人，将账户添加到角色的信任策略只是建立跨账户信任关系工作的一半而已。默认情况下，受信任账户中的任何用户均无法担任角色。新的受信任账户的管理员必须授予用户担任角色的权限。为此，管理员必须创建或编辑附加到用户以允许该用户访问 sts:AssumeRole 操作的策略。有关更多信息，请参阅以下过程或向用户授予切换角色的权限。

4. 要使用您刚刚创建的文件来更新信任策略，请运行以下命令：

   • aws iam update-assume-role-policy

允许受信任外部账户中的用户使用角色 (AWS CLI)

有关此过程的更多详细信息，请参阅向用户授予切换角色的权限。

1. 创建一个 JSON 文件，其中包含授予担任角色的权限的权限策略。例如，下面的策略包含最低必需权限：

   {
     "Version": "2012-10-17",
     "Statement": {
       "Effect": "Allow",
       "Action": "sts:AssumeRole",
       "Resource": "arn:aws-cn:iam::ACCOUNT-ID-THAT-CONTAINS-ROLE:role/ROLE-NAME"
     }
   }

   将语句中的 ARN 替换为用户可担任的角色的 ARN。

2. 运行以下命令来将包含信任策略的 JSON 文件上传到 IAM：

   • aws iam create-policy

   此命令的输出包含策略的 ARN。请记录此 ARN，因为您在后面的步骤中需要它。

3. 决定要将策略附加到哪个用户或组。如果不知道目标用户或组的名称，请使用下列命令之一列出账户中的用户或组：

   • aws iam list-users

   • aws iam list-groups

4. 使用以下命令之一，将您在上一步中创建的策略附加到用户或组：

   • aws iam attach-user-policy

   • aws iam attach-group-policy

更改角色允许的权限 (AWS CLI)

1. （可选）如需查看当前与角色关联的权限，请运行以下命令：

   1. aws iam list-role-policies（用于列出内联策略）

   2. aws iam list-attached-role-policies（用于列出托管策略）

2. 对于更新角色的权限所使用的命令，根据您是在更新托管策略还是内联策略而有所不同。

   要更新托管策略，请运行以下命令以创建托管策略的新版本：

   • aws iam create-policy-version

   要更新内联策略，请运行以下命令：

   • aws iam put-role-policy

更改用于设置角色的权限边界的托管策略 (AWS CLI)

1. （可选）要查看角色的当前权限边界，请运行以下命令：

   • aws iam get-role

2. 要使用不同的托管策略来更新角色的权限边界，请运行以下命令：

   • aws iam put-role-permissions-boundary

   角色只能具有一个设置为权限边界的托管策略。如果您更改权限边界，则会更改允许的角色的最大权限。

更改角色的描述 (AWS CLI)

1. （可选）要查看角色的当前描述，请运行以下命令：

   • aws iam get-role

2. 要更新角色的描述，请带描述参数运行以下命令：

   • aws iam update-role

使用 AWS CLI (AWS CLI) 更改担任的角色的最大会话持续时间设置

1. （可选）要查看角色的当前最大会话持续时间设置，请运行以下命令：

   • aws iam get-role

2. 要更新角色的最大会话持续时间设置，请带 max-sessionduration CLI 参数或 MaxSessionDuration API 参数运行以下命令：

   • aws iam update-role

   在某个人下次担任该角色后，您所做的更改才会生效。要了解如何撤销该角色的现有会话，请参阅撤消 IAM 角色临时安全凭证。

修改角色 (AWS API)

可以使用 AWS API 修改角色。

更改谁可担任角色 (AWS API)

1. （可选）如果不知道要修改的角色的名称，请调用以下操作以列出账户中的角色：

   • ListRoles

2. （可选）要查看角色当前的信任策略，请调用以下操作：

   • GetRole

3. 要修改可访问角色的受信任委托人，请创建带有已更新信任策略的文本文件。您可以使用任何文本编辑器构件策略。

   例如，以下信任策略说明了如何在 Principal 元素中引用两个 AWS 账户。这允许两个单独的 AWS 账户中的用户担任此角色。

   {
       "Version": "2012-10-17",
       "Statement": {
           "Effect": "Allow",
           "Principal": {"AWS": [
               "arn:aws:iam::111122223333:root",
               "arn:aws:iam::444455556666:root"
           ]},
           "Action": "sts:AssumeRole"
       }
   }

   如果您指定其他账户中的委托人，将账户添加到角色的信任策略只是建立跨账户信任关系工作的一半而已。默认情况下，受信任账户中的任何用户均无法担任角色。新的受信任账户的管理员必须授予用户担任角色的权限。为此，管理员必须创建或编辑附加到用户以允许该用户访问 sts:AssumeRole 操作的策略。有关更多信息，请参阅以下过程或向用户授予切换角色的权限。

4. 要使用您刚刚创建的文件来更新信任策略，请调用以下操作：

   • UpdateAssumeRolePolicy

允许受信任外部账户中的用户使用角色 (AWS API)

有关此过程的更多详细信息，请参阅向用户授予切换角色的权限。

1. 创建一个 JSON 文件，其中包含授予担任角色的权限的权限策略。例如，下面的策略包含最低必需权限：

   {
     "Version": "2012-10-17",
     "Statement": {
       "Effect": "Allow",
       "Action": "sts:AssumeRole",
       "Resource": "arn:aws-cn:iam::ACCOUNT-ID-THAT-CONTAINS-ROLE:role/ROLE-NAME"
     }
   }

   将语句中的 ARN 替换为用户可担任的角色的 ARN。

2. 调用以下操作来将包含信任策略的 JSON 文件上传到 IAM：

   • CreatePolicy

   此操作的输出包含策略的 ARN。请记录此 ARN，因为您在后面的步骤中需要它。

3. 决定要将策略附加到哪个用户或组。如果不知道目标用户或组的名称，请调用下列操作之一列出账户中的用户或组：

   • ListUsers

   • ListGroups

4. 调用以下操作之一，将您在上一步中创建的策略附加到用户或组：

   • API：AttachUserPolicy

   • AttachGroupPolicy

更改角色允许的权限 (AWS API)

1. （可选）如需查看当前与角色关联的权限，请调用以下操作：

   1. ListRolePolicies（用于列出内联策略）

   2. ListAttachedRolePolicies（用于列出托管策略）

2. 对于更新角色的权限所使用的操作，根据您是在更新托管策略还是内联策略而有所不同。

   要更新托管策略，请调用以下操作以创建托管策略的新版本：

   • CreatePolicyVersion

   要更新内联策略，请调用以下操作：

   • PutRolePolicy

更改用于设置角色的权限边界的托管策略 (AWS API)

1. （可选）要查看角色的当前权限边界，请调用以下操作：

   • GetRole

2. 要使用不同的托管策略来更新角色的权限边界，请调用以下操作：

   • PutRolePermissionsBoundary

   角色只能具有一个设置为权限边界的托管策略。如果您更改权限边界，则会更改允许的角色的最大权限。

更改角色的描述 (AWS API)

1. （可选）要查看角色当前的描述，请调用以下操作：

   • GetRole

2. 要更新角色的描述，请带描述参数调用以下操作：

   • UpdateRole

使用 API 更改担任的角色的最大会话持续时间设置 (AWS API)

1. （可选）要查看角色的当前最大会话持续时间设置，请调用以下操作：

   • GetRole

2. 要更新角色的最大会话持续时间设置，请带 max-sessionduration CLI 参数或 MaxSessionDuration API 参数调用以下操作：

   • UpdateRole

   在某个人下次担任该角色后，您所做的更改才会生效。要了解如何撤销该角色的现有会话，请参阅撤消 IAM 角色临时安全凭证。

本页内容：

• 查看角色访问
• 修改角色 (控制台)
• 修改角色 (AWS CLI)
• 修改角色 (AWS API)