com.amazonaws.services.ec2.model
Class CreateSubnetRequest

java.lang.Object
  com.amazonaws.AmazonWebServiceRequest
      com.amazonaws.services.ec2.model.CreateSubnetRequest

public class CreateSubnetRequest
extends AmazonWebServiceRequest

Container for the parameters to the CreateSubnet operation.

Creates a subnet in an existing VPC. You can create up to 20 subnets in a VPC. 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. When you create each subnet, you provide the VPC ID and the CIDR block you want for the subnet. Once 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 /18 netmask (16,384 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.

See Also:

AmazonEC2.createSubnet(CreateSubnetRequest)

Constructor Summary

CreateSubnetRequest()
Default constructor for a new CreateSubnetRequest object.

CreateSubnetRequest(String vpcId, String cidrBlock)
Constructs a new CreateSubnetRequest object.

Method Summary

String	getAvailabilityZone() The Availability Zone to create the subnet in.
String	getCidrBlock() The CIDR block the subnet is to cover.
String	getVpcId() The ID of the VPC to create the subnet in.
void	setAvailabilityZone(String availabilityZone) The Availability Zone to create the subnet in.
void	setCidrBlock(String cidrBlock) The CIDR block the subnet is to cover.
void	setVpcId(String vpcId) The ID of the VPC to create the subnet in.
String	toString() Returns a string representation of this object; useful for testing and debugging.
CreateSubnetRequest	withAvailabilityZone(String availabilityZone) The Availability Zone to create the subnet in.
CreateSubnetRequest	withCidrBlock(String cidrBlock) The CIDR block the subnet is to cover.
CreateSubnetRequest	withVpcId(String vpcId) The ID of the VPC to create the subnet in.

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

copyPrivateRequestParameters, getRequestCredentials, setRequestCredentials

Methods inherited from class java.lang.Object

equals, getClass, hashCode, 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 to create the subnet in.

cidrBlock - The CIDR block the subnet is to cover.

Method Detail

getVpcId

public String getVpcId()

The ID of the VPC to create the subnet in.

Returns:

The ID of the VPC to create the subnet in.

setVpcId

public void setVpcId(String vpcId)

The ID of the VPC to create the subnet in.

Parameters:

vpcId - The ID of the VPC to create the subnet in.

withVpcId

public CreateSubnetRequest withVpcId(String vpcId)

The ID of the VPC to create the subnet in.

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

Parameters:

vpcId - The ID of the VPC to create the subnet in.

Returns:

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

getCidrBlock

public String getCidrBlock()

The CIDR block the subnet is to cover.

Returns:

The CIDR block the subnet is to cover.

setCidrBlock

public void setCidrBlock(String cidrBlock)

The CIDR block the subnet is to cover.

Parameters:

cidrBlock - The CIDR block the subnet is to cover.

withCidrBlock

public CreateSubnetRequest withCidrBlock(String cidrBlock)

The CIDR block the subnet is to cover.

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

Parameters:

cidrBlock - The CIDR block the subnet is to cover.

Returns:

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

getAvailabilityZone

public String getAvailabilityZone()

The Availability Zone to create the subnet in.

Returns:

The Availability Zone to create the subnet in.

setAvailabilityZone

public void setAvailabilityZone(String availabilityZone)

The Availability Zone to create the subnet in.

Parameters:

availabilityZone - The Availability Zone to create the subnet in.

withAvailabilityZone

public CreateSubnetRequest withAvailabilityZone(String availabilityZone)

The Availability Zone to create the subnet in.

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

Parameters:

availabilityZone - The Availability Zone to create the subnet in.

Returns:

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

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()