Copyright | (c) 2013-2016 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
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.
- createSubnet :: Text -> Text -> CreateSubnet
- data CreateSubnet
- cssAvailabilityZone :: Lens' CreateSubnet (Maybe Text)
- cssDryRun :: Lens' CreateSubnet (Maybe Bool)
- cssVPCId :: Lens' CreateSubnet Text
- cssCIdRBlock :: Lens' CreateSubnet Text
- createSubnetResponse :: Int -> CreateSubnetResponse
- data CreateSubnetResponse
- crsSubnet :: Lens' CreateSubnetResponse (Maybe Subnet)
- crsResponseStatus :: Lens' CreateSubnetResponse Int
Creating a Request
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:
data CreateSubnet Source #
Contains the parameters for CreateSubnet.
See: createSubnet
smart constructor.
Request Lenses
cssAvailabilityZone :: Lens' CreateSubnet (Maybe Text) Source #
The Availability Zone for the subnet.
Default: AWS selects one for you. If you create more than one subnet in your VPC, we may not necessarily select a different zone for each subnet.
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
.
cssCIdRBlock :: Lens' CreateSubnet Text Source #
The network range for the subnet, in CIDR notation. For example, '10.0.0.0\/24'.
Destructuring the Response
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:
data CreateSubnetResponse Source #
Contains the output of CreateSubnet.
See: createSubnetResponse
smart constructor.
Response Lenses
crsResponseStatus :: Lens' CreateSubnetResponse Int Source #
The response status code.