Amazon Elastic Compute Cloud

{'Address': 'string'}

Allocates an Elastic IP address.

An Elastic IP address is for use either in the EC2-Classic platform or in a VPC. By default, you can allocate 5 Elastic IP addresses for EC2-Classic per region and 5 Elastic IP addresses for EC2-VPC per region.

If you release an Elastic IP address for use in a VPC, you might be able to recover it. To recover an Elastic IP address that you released, specify it in the Address parameter. Note that you cannot recover an Elastic IP address that you released after it is allocated to another AWS account.

For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

See also: AWS API Documentation

Request Syntax

client.allocate_address(
    Domain='vpc'|'standard',
    Address='string',
    DryRun=True|False
)

type Domain:

string

param Domain:

Set to vpc to allocate the address for use with instances in a VPC.

Default: The address is for use with instances in EC2-Classic.

type Address:

string

param Address:

[EC2-VPC] The Elastic IP address to recover.

type DryRun:

boolean

param DryRun:

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.

rtype:

dict

returns:

Response Syntax

{
    'PublicIp': 'string',
    'AllocationId': 'string',
    'Domain': 'vpc'|'standard'
}

Response Structure

• (dict) --

  Contains the output of AllocateAddress.

  • PublicIp (string) --

    The Elastic IP address.

  • AllocationId (string) --

    [EC2-VPC] The ID that AWS assigns to represent the allocation of the Elastic IP address for use with instances in a VPC.

  • Domain (string) --

    Indicates whether this Elastic IP address is for use with instances in EC2-Classic ( standard) or instances in a VPC ( vpc).