amazonka-ec2-1.3.1: Amazon Elastic Compute Cloud SDK.

Copyright(c) 2013-2015 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <>
Portabilitynon-portable (GHC extensions)
Safe HaskellNone




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

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: AWS API Reference for CreateSubnet.


Creating a Request

createSubnet Source

Creates a value of CreateSubnet with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Request Lenses

cssAvailabilityZone :: Lens' CreateSubnet (Maybe Text) Source

The Availability Zone for the subnet.

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

cssDryRun :: Lens' CreateSubnet (Maybe Bool) Source

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.

cssVPCId :: Lens' CreateSubnet Text Source

The ID of the VPC.

cssCIdRBlock :: Lens' CreateSubnet Text Source

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

Destructuring the Response

createSubnetResponse Source

Creates a value of CreateSubnetResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Response Lenses

crsSubnet :: Lens' CreateSubnetResponse (Maybe Subnet) Source

Information about the subnet.