Renaming an organizational unit (OU) with AWS Organizations - AWS Organizations

Renaming an organizational unit (OU) with AWS Organizations

When you sign in to your organization's management account, you can rename an OU. To do this, complete the following steps.

Minimum permissions

To rename an OU within a root in your organization, you must have the following permissions:

  • organizations:DescribeOrganization – required only when using the Organizations console

  • organizations:UpdateOrganizationalUnit

AWS Management Console
To rename an OU

  1. Sign in to the AWS Organizations console. You must sign in as an IAM user, assume an IAM role, or sign in as the root user (not recommended) in the organization’s management account.

  2. On the AWS accounts page, navigate to the OU that you want to rename, and then do one of the following steps:

    • Choose the radio button Blue circular icon with a white checkmark symbol in the center. next to the OU that you want to rename. Then, on the Actions menu, under Organizational unit, choose Rename.

    • Choose the OU's name, to access the OU's detail page. Then, at the top of the page choose Rename.

  3. In the Rename organizational unit dialog box, enter a new name, and then choose Save changes.

AWS CLI & AWS SDKs
To rename an OU

You can use one of the following commands to rename an OU:

  • AWS CLI: update-organizational-unit

    The following example shows how to rename an OU.

    $ aws organizations update-organizational-unit \
    --organizational-unit-id ou-a1b2-f6g7h222 \
    --name "Renamed-OU"
{
    "OrganizationalUnit": {
        "Id": "ou-a1b2-f6g7h222",
        "Arn": "arn:aws:organizations::123456789012:ou/o-aa111bb222/ou-a1b2-f6g7h222",
        "Name": "Renamed-OU"
    }
}

  • AWS SDKs: UpdateOrganizationalUnit