IAM / Client / delete_account_alias

delete_account_alias#

IAM.Client.delete_account_alias(**kwargs)#

Deletes the specified Amazon Web Services account alias. For information about using an Amazon Web Services account alias, see Creating, deleting, and listing an Amazon Web Services account alias in the Amazon Web Services Sign-In User Guide.

See also: AWS API Documentation

Request Syntax

response = client.delete_account_alias(
    AccountAlias='string'
)
Parameters:

AccountAlias (string) –

[REQUIRED]

The name of the account alias to delete.

This parameter allows (through its regex pattern) a string of characters consisting of lowercase letters, digits, and dashes. You cannot start or finish with a dash, nor can you have two dashes in a row.

Returns:

None

Exceptions

Examples

The following command removes the alias mycompany from the current AWS account:

response = client.delete_account_alias(
    AccountAlias='mycompany',
)

print(response)

Expected Output:

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