com.amazonaws.services.ec2.model

Class CreateSubnetRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.ec2.model.CreateSubnetRequest

All Implemented Interfaces:

ReadLimitInfo, DryRunSupportedRequest<CreateSubnetRequest>, Serializable, Cloneable

public class CreateSubnetRequest
extends AmazonWebServiceRequest
implements Serializable, Cloneable, DryRunSupportedRequest<CreateSubnetRequest>

Container for the parameters to the CreateSubnet operation.

Creates a subnet in an existing VPC.

When you create each subnet, you provide the VPC ID and the CIDR block you want for the subnet. After you create a subnet, you can't change its CIDR block. The subnet's CIDR block can be the same as the VPC's CIDR block (assuming you want only a single subnet in the VPC), or a subset of the VPC's CIDR block. If you create more than one subnet in a VPC, the subnets' CIDR blocks must not overlap. The smallest subnet (and VPC) you can create uses a /28 netmask (16 IP addresses), and the largest uses a /16 netmask (65,536 IP addresses).

IMPORTANT: AWS reserves both the first four and the last IP address in each subnet's CIDR block. They're not available for use.

If you add more than one subnet to a VPC, they're set up in a star topology with a logical router in the middle.

If you launch an instance in a VPC using an Amazon EBS-backed AMI, the IP address doesn't change if you stop and restart the instance (unlike a similar instance launched outside a VPC, which gets a new IP address when restarted). It's therefore possible to have a subnet with no running instances (they're all stopped), but no remaining IP addresses available.

For more information about subnets, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide .

See Also:

AmazonEC2.createSubnet(CreateSubnetRequest), Serialized Form

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceRequest

NOOP

Constructor Summary

Constructors

Constructor and Description
CreateSubnetRequest() Default constructor for a new CreateSubnetRequest object.
CreateSubnetRequest(String vpcId, String cidrBlock) Constructs a new CreateSubnetRequest object.

Method Summary

Methods

Modifier and Type	Method and Description
CreateSubnetRequest	clone()
boolean	equals(Object obj)
String	getAvailabilityZone() The Availability Zone for the subnet.
String	getCidrBlock() The network range for the subnet, in CIDR notation.
Request<CreateSubnetRequest>	getDryRunRequest() This method is intended for internal use only.
String	getVpcId() The ID of the VPC.
int	hashCode()
void	setAvailabilityZone(String availabilityZone) The Availability Zone for the subnet.
void	setCidrBlock(String cidrBlock) The network range for the subnet, in CIDR notation.
void	setVpcId(String vpcId) The ID of the VPC.
String	toString() Returns a string representation of this object; useful for testing and debugging.
CreateSubnetRequest	withAvailabilityZone(String availabilityZone) The Availability Zone for the subnet.
CreateSubnetRequest	withCidrBlock(String cidrBlock) The network range for the subnet, in CIDR notation.
CreateSubnetRequest	withVpcId(String vpcId) The ID of the VPC.

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

copyBaseTo, getCloneRoot, getCloneSource, getCustomQueryParameters, getCustomRequestHeaders, getGeneralProgressListener, getReadLimit, getRequestClientOptions, getRequestCredentials, getRequestMetricCollector, putCustomQueryParameter, putCustomRequestHeader, setGeneralProgressListener, setRequestCredentials, setRequestMetricCollector, withGeneralProgressListener, withRequestMetricCollector

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

CreateSubnetRequest

public CreateSubnetRequest()

Default constructor for a new CreateSubnetRequest object. Callers should use the setter or fluent setter (with...) methods to initialize this object after creating it.

CreateSubnetRequest

public CreateSubnetRequest(String vpcId,
                   String cidrBlock)

Constructs a new CreateSubnetRequest object. Callers should use the setter or fluent setter (with...) methods to initialize any additional object members.

Parameters:

vpcId - The ID of the VPC.

cidrBlock - The network range for the subnet, in CIDR notation. For example, 10.0.0.0/24.

Method Detail

getVpcId

public String getVpcId()

The ID of the VPC.

Returns:

The ID of the VPC.

setVpcId

public void setVpcId(String vpcId)

The ID of the VPC.

Parameters:

vpcId - The ID of the VPC.

withVpcId

public CreateSubnetRequest withVpcId(String vpcId)

The ID of the VPC.

Returns a reference to this object so that method calls can be chained together.

Parameters:

vpcId - The ID of the VPC.

Returns:

A reference to this updated object so that method calls can be chained together.

getCidrBlock

public String getCidrBlock()

The network range for the subnet, in CIDR notation. For example, 10.0.0.0/24.

Returns:

The network range for the subnet, in CIDR notation. For example, 10.0.0.0/24.

setCidrBlock

public void setCidrBlock(String cidrBlock)

The network range for the subnet, in CIDR notation. For example, 10.0.0.0/24.

Parameters:

cidrBlock - The network range for the subnet, in CIDR notation. For example, 10.0.0.0/24.

withCidrBlock

public CreateSubnetRequest withCidrBlock(String cidrBlock)

The network range for the subnet, in CIDR notation. For example, 10.0.0.0/24.

Returns a reference to this object so that method calls can be chained together.

Parameters:

cidrBlock - The network range for the subnet, in CIDR notation. For example, 10.0.0.0/24.

Returns:

A reference to this updated object so that method calls can be chained together.

getAvailabilityZone

public String getAvailabilityZone()

The Availability Zone for the subnet.

Default: Amazon EC2 selects one for you (recommended).

Returns:

The Availability Zone for the subnet.

Default: Amazon EC2 selects one for you (recommended).

setAvailabilityZone

public void setAvailabilityZone(String availabilityZone)

The Availability Zone for the subnet.

Default: Amazon EC2 selects one for you (recommended).

Parameters:

availabilityZone - The Availability Zone for the subnet.

Default: Amazon EC2 selects one for you (recommended).

withAvailabilityZone

public CreateSubnetRequest withAvailabilityZone(String availabilityZone)

The Availability Zone for the subnet.

Default: Amazon EC2 selects one for you (recommended).

Returns a reference to this object so that method calls can be chained together.

Parameters:

availabilityZone - The Availability Zone for the subnet.

Default: Amazon EC2 selects one for you (recommended).

Returns:

A reference to this updated object so that method calls can be chained together.

getDryRunRequest

public Request<CreateSubnetRequest> getDryRunRequest()

This method is intended for internal use only. Returns the marshaled request configured with additional parameters to enable operation dry-run.

Specified by:

getDryRunRequest in interface DryRunSupportedRequest<CreateSubnetRequest>

toString

public String toString()

Returns a string representation of this object; useful for testing and debugging.

Overrides:

toString in class Object

Returns:

A string representation of this object.

See Also:

Object.toString()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

clone

public CreateSubnetRequest clone()

Overrides:

clone in class AmazonWebServiceRequest