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.

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