Organizations / Client / move_account

move_account#

Organizations.Client.move_account(**kwargs)#

Moves an account from its current source parent root or organizational unit (OU) to the specified destination parent root or OU.

This operation can be called only from the organization’s management account.

See also: AWS API Documentation

Request Syntax

response = client.move_account(
    AccountId='string',
    SourceParentId='string',
    DestinationParentId='string'
)
Parameters:

  • AccountId (string) –

    [REQUIRED]

    The unique identifier (ID) of the account that you want to move.

    The regex pattern for an account ID string requires exactly 12 digits.

  • SourceParentId (string) –

    [REQUIRED]

    The unique identifier (ID) of the root or organizational unit that you want to move the account from.

    The regex pattern for a parent ID string requires one of the following:

    • Root - A string that begins with “r-” followed by from 4 to 32 lowercase letters or digits.

    • Organizational unit (OU) - A string that begins with “ou-” followed by from 4 to 32 lowercase letters or digits (the ID of the root that the OU is in). This string is followed by a second “-” dash and from 8 to 32 additional lowercase letters or digits.

  • DestinationParentId (string) –

    [REQUIRED]

    The unique identifier (ID) of the root or organizational unit that you want to move the account to.

    The regex pattern for a parent ID string requires one of the following:

    • Root - A string that begins with “r-” followed by from 4 to 32 lowercase letters or digits.

    • Organizational unit (OU) - A string that begins with “ou-” followed by from 4 to 32 lowercase letters or digits (the ID of the root that the OU is in). This string is followed by a second “-” dash and from 8 to 32 additional lowercase letters or digits.

Returns:

None

Exceptions

  • Organizations.Client.exceptions.AccessDeniedException

  • Organizations.Client.exceptions.InvalidInputException

  • Organizations.Client.exceptions.SourceParentNotFoundException

  • Organizations.Client.exceptions.DestinationParentNotFoundException

  • Organizations.Client.exceptions.DuplicateAccountException

  • Organizations.Client.exceptions.AccountNotFoundException

  • Organizations.Client.exceptions.TooManyRequestsException

  • Organizations.Client.exceptions.ConcurrentModificationException

  • Organizations.Client.exceptions.AWSOrganizationsNotInUseException

  • Organizations.Client.exceptions.ServiceException

Examples

The following example shows how to move a member account from the root to an OU:/n/n

response = client.move_account(
    AccountId='333333333333',
    DestinationParentId='ou-examplerootid111-exampleouid111',
    SourceParentId='r-examplerootid111',
)

print(response)

Expected Output:

{
    'ResponseMetadata': {
        '...': '...',
    },
}