# 重命名 IAM 用户组
<a name="id_groups_manage_rename"></a>

当您更改用户组的名称或路径时，发生以下情况：
+ 应用于用户组的所有策略采用新群组名称继续生效。
+ 该用户组采用新名称保留所有用户。
+ 该用户组的唯一 ID 保持不变。有关唯一 ID 的更多信息，请参阅 [唯一标识符](reference_identifiers.md#identifiers-unique-ids)。

IAM 不自动更新将该用户组作为资源引用的策略以使用新名称。因此，重命名用户组时，请务必保持谨慎。在重命名用户组之前，您必须手动检查所有策略以按名称查找提到该用户组的任何策略。例如，假设 Bob 是公司测试部门的经理。Bob 向他的 IAM 用户实体中挂载了一个策略，该策略允许他在“测试”用户组中添加和删除用户。如果管理员更改用户组的名称（或更改组的路径），则管理员还必须更新附加到 Bob 的策略以使用新名称或新路径。否则，Bob 将无法在该用户组中添加或删除用户。

**查找将 IAM 组作为资源引用的策略：**

1. 从 IAM 控制台的导航窗格中，选择 **Policies**（策略）。

1. 按 **Type**（类型）列排序，以查找您的 **Customer managed**（客户托管）自定义策略。

1. 请选择策略的名称进行编辑。

1. 选择**权限**选项卡，然后选择**摘要**。

1. 从服务列表中选择 **IAM**（如果存在）

1. 在**资源**列中查找您的用户组名称。

1. 选择**编辑**以在策略中更改您的用户组名称。

## 更改 IAM 用户组的名称
<a name="id_groups_manage_rename-section-1"></a>

------
#### [ Console ]

1. 在导航窗格中，选择 **用户组**，然后选择组的名称。

1. 选择**编辑**。键入新的用户组名称，然后选择 **Save changes**（保存更改）。

------
#### [ AWS CLI ]

运行以下命令：
+ [aws iam update-group](https://docs.aws.amazon.com/cli/latest/reference/iam/update-group.html)

------
#### [ API ]

调用以下操作：
+ [UpdateGroup](https://docs.aws.amazon.com/IAM/latest/APIReference/API_UpdateGroup.html)

------