The rename command renames a user group. The root group of the authentication domain cannot be renamed.
| Parameter | Description | Value |
|---|---|---|
| group-name | Specifies the new group name without any group path. | The value is a case-sensitive string, starting with a slash (/). It supports spaces, but does not support any commas (,), quotation marks ("), or question marks (?). If the group name does not contain any space, its length ranges from 2 to 225. If the group name contains spaces, its length ranges from 4 to 227, and you must enclose the name with double quotation marks ("), for example, "/group for test". The name cannot start or end with any spaces. The new name cannot be the same as the name of any existing group under the same path. In addition, the name with the group path cannot be longer than 225 characters. |
After you rename a user group, the system automatically updates the group path of its subgroups and the policies that reference the user group. No manual modification is required. For example, after you rename group /default/g1/g2 in the /default group to /default/g1/gx, the system automatically updates the group path of subgroup /defaultg1/g2/g3 to /default/g1/gx/g3. At the same time, the system automatically replaces /default/g1/g2/g3 referenced by policies with /default/g1/gx/g3.