EC2 / Client / disassociate_address

disassociate_address

EC2.Client.disassociate_address(**kwargs)

Disassociates an Elastic IP address from the instance or network interface it’s associated with.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn’t return an error.

An address cannot be disassociated if the all of the following conditions are met:

• Network interface has a publicDualStackDnsName publicDnsName

• Public IPv4 address is the primary public IPv4 address

• Network interface only has one remaining public IPv4 address

See also: AWS API Documentation

Request Syntax

response = client.disassociate_address(
    AssociationId='string',
    PublicIp='string',
    DryRun=True|False
)

Parameters:

• AssociationId (string) – The association ID. This parameter is required.

• PublicIp (string) – Deprecated.

• DryRun (boolean) – Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

Returns:

None

Examples

This example disassociates an Elastic IP address from an instance in a VPC.

response = client.disassociate_address(
    AssociationId='eipassoc-2bebb745',
)

print(response)

Expected Output:

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

This example disassociates an Elastic IP address from an instance in EC2-Classic.

response = client.disassociate_address(
    PublicIp='198.51.100.0',
)

print(response)

Expected Output:

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