How do I move an account from an existing organization to another organization in AWS Organizations?

4 minute read
3

I want to move my member account from an existing organization to another organization in AWS Organizations.

Resolution

Note: If you receive errors when you run AWS Command Line Interface (AWS CLI) commands, then see Troubleshooting errors for the AWS CLI. Also, make sure that you're using the most recent AWS CLI version.

Prepare for the move

Before you move your accounts, verify the following:

  • You have the necessary permissions to move the management and member accounts in the organization.
    Note: If you can't leave the organization, then contact AWS Support.
  • If you sign in as an AWS Identity and Access Management (IAM) user, then you must have the aws-portal:ModifyBilling and aws-portal:ModifyPaymentMethods permissions. Also, check that you activated the IAM user for access to billing.
  • You have backups of reports from the member accounts that you must keep. You can't access the reports after you move the member accounts.
  • You have a valid payment method on the member account for charges that you incur when you're moving the account.
  • You reviewed and updated the tax information for accounts that you're moving from one organization to another.
  • You changed the AWS Support plan to move developer or business accounts.
    Note: If you don't change or cancel the AWS Support plan for the developer or business accounts, then you have to pay to move those accounts.
  • To share AWS resources with an account that you're moving, you must turn on resource sharing with AWS Organizations before you move the account.
  • Make sure that you didn't reach your Organizations quota for the number of accounts in your organization.

Important: If you have a pricing agreement with AWS and you want to move your management account to a different organization, then contact your account manager.

Also, review the following resources:

Move developer or business accounts

If you're moving only a few accounts, then use the AWS Organizations console. If you're moving numerous accounts, then use either the AWS Organizations API or AWS CLI. For more information, see Migrating an account to another organization with AWS Organizations.

Complete the following steps for each member account:

  1. Remove the member account from the old organization.
  2. Send an invite to the member account from the new organization.
  3. Accept the invite to the new organization from the member account.

To join the old organization's management account to the new organization, complete the following steps:

  1. Remove the member accounts from the organization.
  2. Delete the old organization.
  3. Invite the old management account to the new organization as a member account.

Related information

How do AWS Support plans work in an organization in AWS Organizations?

3 Comments

"The account that was used to purchase the Savings Plan owns the Savings Plan. If you leave the Organization, then the Savings Plan remains on the account that purchased the Savings Plan."

does this apply to RI? if yes we should specify it in the article (@bllecoq)

profile pictureAWS
EXPERT
replied 2 years ago

Thank you for your comment. We'll review and update the Knowledge Center article as needed.

profile pictureAWS
EXPERT
replied 2 years ago

Also, It's important to verify if there is some resource shared by the Resource Access Manager in the organization. If it has, the customer also needs to make the share in the new org.

profile pictureAWS
replied 3 months ago