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.

You can only call this operation from the management account.

See also: AWS API Documentation

Request Syntax

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

  • AccountId (string) –

    [REQUIRED]

    ID for the account that you want to move.

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

  • SourceParentId (string) –

    [REQUIRED]

    ID for 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]

    ID for 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

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': {
        '...': '...',
    },
}