Deleting OUs - Amazon Organizations
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Deleting OUs

When you sign in to your organization's management account, you can delete any OUs that you no longer need.

You must first move all accounts out of the OU and any child OUs, and then you can delete the child OUs.

Minimum permissions

To delete an OU, you must have the following permissions:

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

  • organizations:DeleteOrganizationalUnit

Amazon Web Services Management Console
To delete an OU

  1. Sign in to the Amazon 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 Amazon Web Services accounts page, find the OUs that you want to delete and choose the check box next to each OU's name.

  3. Choose Actions, and then under Organizational unit, choose Delete.

  4. To confirm that you want to delete the OUs, enter the OU's name (if you chose to delete only one) or the word 'delete' (if you chose more than one), and then choose Delete.

    Amazon Organizations deletes the OUs and removes them from the list.

Amazon CLI & Amazon SDKs
To delete an OU

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

  • Amazon CLI: delete-organizational-unit

    The following example shows how to delete an OU.

    $ aws organizations delete-organizational-unit \
    --organizational-unit-id ou-a1b2-f6g7h222

    This command produces no output when successful.

  • Amazon SDKs: DeleteOrganizationalUnit