AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Container for the parameters to the AllocateAddress operation. 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.

Inheritance Hierarchy

System.Object
  Amazon.Runtime.AmazonWebServiceRequest
    Amazon.EC2.AmazonEC2Request
      Amazon.EC2.Model.AllocateAddressRequest

Namespace: Amazon.EC2.Model
Assembly: AWSSDK.EC2.dll
Version: 3.x.y.z

Syntax

C#
public class AllocateAddressRequest : AmazonEC2Request
         IAmazonWebServiceRequest

The AllocateAddressRequest type exposes the following members

Constructors

NameDescription
Public Method AllocateAddressRequest()

Properties

NameTypeDescription
Public Property Address System.String

Gets and sets the property Address.

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

Public Property Domain Amazon.EC2.DomainType

Gets and sets the property 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.

Examples

This example allocates an Elastic IP address to use with an instance in a VPC.

To allocate an Elastic IP address for EC2-VPC


var response = client.AllocateAddress(new AllocateAddressRequest 
{
    Domain = "vpc"
});

string allocationId = response.AllocationId;
string domain = response.Domain;
string publicIp = response.PublicIp;

            

This example allocates an Elastic IP address to use with an instance in EC2-Classic.

To allocate an Elastic IP address for EC2-Classic


var response = client.AllocateAddress(new AllocateAddressRequest 
{
});

string domain = response.Domain;
string publicIp = response.PublicIp;

            

Version Information

.NET Standard:
Supported in: 1.3

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms