Deleting an organization with Amazon Organizations - Amazon Organizations
ConsiderationsDelete an organization
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 an organization with Amazon Organizations

When you no longer need your organization, you can delete it. Deleting an organization does not close the management account, instead it removes the management account from the organization and deletes the organization itself.

The former management account becomes a standalone Amazon Web Services account that is no longer managed by Amazon Organizations. You then have three options:

  • You can continue to use it as a standalone account

  • You can use it to create a different organization

  • You can accept an invitation from another organization to add the account to that organization as a member account.

Considerations

Deleted organizations cannot be recovered

If you delete an organization, you can't recover it. If you created any policies inside of the organization, they're also deleted and you can't recover them.

Organizations can only be deleted after all member account have been removed

You can delete an organization only after you remove all member accounts from the organization. If you created some of your member accounts using Amazon Organizations, you might be blocked from removing those accounts. You can remove a member account only if it has all the information that's required to operate as a standalone Amazon Web Services account. For more information about how to provide that information and then remove the account, see Leave an organization from a member account with Amazon Organizations.

Member accounts in a 'suspended' state cannot be removed from an organization

If you closed a member account before you remove it from the organization, it enters a 'suspended' state for a period of time and you can't remove the account from the organization until it is finally closed. This can prevent you from deleting the organization until all member accounts are completely closed.

Removing the management account from an organization by deleting the organization can affect the account in the following ways:

  • The account is responsible for paying only its own charges and is no longer responsible for the charges incurred by any other account.

  • Integration with other services might be disabled. For example, Amazon IAM Identity Center requires an organization to operate, so if you remove an account from an organization that supports IAM Identity Center, the users in that account can no longer use that service.

The management account of an organization is never affected by service control policies (SCPs), so there is no change in permissions after SCPs are no longer available.

Back up all reports

Make sure to export or back up reports from the management account, especially billing reports. Organizational level reports and history are not stored when you delete an organization. All cost data (such as the Cost Explorer data set) is deleted. It is recommended that you do a full export of all billing history.

For more information, see Cost and Usage Reports, Cost Explorer Reports, Savings Plans Reports, and Reserved Instance (RI) utilization and coverage.

Delete an organization

Use the following procedure to delete an organization which reverts the former management account to a standalone Amazon Web Services account that is no longer managed by Amazon Organizations.

Minimum permissions

To delete an organization, you must sign in as a user or role in the management account, and you must have the following permissions:

  • organizations:DeleteOrganization

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

To delete an organization

  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. Before you can delete the organization, you must first remove all accounts from the organization. For more information, see Removing a member account from an organization with Amazon Organizations.

  3. Navigate to the Settings page, and then choose Delete organization.

  4. In the Delete organization confirmation dialog box, enter the organization's ID which is displayed in the line above the text box. Then, choose Delete organization.

    Important

    This operation does not close the management account but does return it to a standalone Amazon Web Services account. To close the account, follow the steps at Closing a member account in an organization with Amazon Organizations.

The following code examples show how to use DeleteOrganization.

.NET
Amazon SDK for .NET
Note

There's more on GitHub. Find the complete example and learn how to set up and run in the Amazon Code Examples Repository. 

    using System;
    using System.Threading.Tasks;
    using Amazon.Organizations;
    using Amazon.Organizations.Model;

    /// <summary>
    /// Shows how to delete an existing organization using the AWS
    /// Organizations Service.
    /// </summary>
    public class DeleteOrganization
    {
        /// <summary>
        /// Initializes the Organizations client and then calls
        /// DeleteOrganizationAsync to delete the organization.
        /// </summary>
        public static async Task Main()
        {
            // Create the client object using the default account.
            IAmazonOrganizations client = new AmazonOrganizationsClient();

            var response = await client.DeleteOrganizationAsync(new DeleteOrganizationRequest());

            if (response.HttpStatusCode == System.Net.HttpStatusCode.OK)
            {
                Console.WriteLine("Successfully deleted organization.");
            }
            else
            {
                Console.WriteLine("Could not delete organization.");
            }
        }
    }
CLI
Amazon CLI

To delete an organization

The following example shows how to delete an organization. To perform this operation, you must be an admin of the master account in the organization. The example assumes that you previously removed all the member accounts, OUs, and policies from the organization:

aws organizations delete-organization