subnet

Gets an individual subnet resource

Overview

Name	subnet
Type	Resource
Description	subnet
Id	awscc.ec2.subnet

Fields

Name	Datatype	Description
assign_ipv6_address_on_creation	boolean	Indicates whether a network interface created in this subnet receives an IPv6 address. The default value is ``false``.<br/> If you specify ``AssignIpv6AddressOnCreation``, you must also specify an IPv6 CIDR block.
vpc_id	string	The ID of the VPC the subnet is in.<br/> If you update this property, you must also update the ``CidrBlock`` property.
map_public_ip_on_launch	boolean	Indicates whether instances launched in this subnet receive a public IPv4 address. The default value is ``false``.<br/> AWS charges for all public IPv4 addresses, including public IPv4 addresses associated with running instances and Elastic IP addresses. For more information, see the *Public IPv4 Address* tab on the [VPC pricing page](https://docs.aws.amazon.com/vpc/pricing/).
network_acl_association_id	string
availability_zone	string	The Availability Zone of the subnet.<br/> If you update this property, you must also update the ``CidrBlock`` property.
availability_zone_id	string	The AZ ID of the subnet.
cidr_block	string	The IPv4 CIDR block assigned to the subnet.<br/> If you update this property, we create a new subnet, and then delete the existing one.
subnet_id	string
ipv6_cidr_blocks	array	The IPv6 network ranges for the subnet, in CIDR notation.
ipv6_cidr_block	string	The IPv6 CIDR block.<br/> If you specify ``AssignIpv6AddressOnCreation``, you must also specify an IPv6 CIDR block.
outpost_arn	string	The Amazon Resource Name (ARN) of the Outpost.
ipv6_native	boolean	Indicates whether this is an IPv6 only subnet. For more information, see [Subnet basics](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html#subnet-basics) in the *User Guide*.
enable_dns64	boolean	Indicates whether DNS queries made to the Amazon-provided DNS Resolver in this subnet should return synthetic IPv6 addresses for IPv4-only destinations. For more information, see [DNS64 and NAT64](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html#nat-gateway-nat64-dns64) in the *User Guide*.
private_dns_name_options_on_launch	object	The hostname type for EC2 instances launched into this subnet and how DNS A and AAAA record queries to the instances should be handled. For more information, see [Amazon EC2 instance hostname types](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-naming.html) in the *User Guide*.<br/> Available options:<br/> + EnableResourceNameDnsAAAARecord (true | false)<br/> + EnableResourceNameDnsARecord (true | false)<br/> + HostnameType (ip-name | resource-name)
tags	array	Any tags assigned to the subnet.
ipv4_ipam_pool_id	string	An IPv4 IPAM pool ID for the subnet.
ipv4_netmask_length	integer	An IPv4 netmask length for the subnet.
ipv6_ipam_pool_id	string	An IPv6 IPAM pool ID for the subnet.
ipv6_netmask_length	integer	An IPv6 netmask length for the subnet.
region	string	AWS region.

Methods

Currently only SELECT is supported for this resource resource.

Example

SELECT
region,
assign_ipv6_address_on_creation,
vpc_id,
map_public_ip_on_launch,
network_acl_association_id,
availability_zone,
availability_zone_id,
cidr_block,
subnet_id,
ipv6_cidr_blocks,
ipv6_cidr_block,
outpost_arn,
ipv6_native,
enable_dns64,
private_dns_name_options_on_launch,
tags,
ipv4_ipam_pool_id,
ipv4_netmask_length,
ipv6_ipam_pool_id,
ipv6_netmask_length
FROM awscc.ec2.subnet
WHERE data__Identifier = '<SubnetId>';

Permissions

To operate on the subnet resource, the following permissions are required:

Read

ec2:DescribeSubnets,
ec2:DescribeNetworkAcls

Update

ec2:DescribeSubnets,
ec2:ModifySubnetAttribute,
ec2:CreateTags,
ec2:DeleteTags,
ec2:AssociateSubnetCidrBlock,
ec2:DisassociateSubnetCidrBlock

Delete

ec2:DescribeSubnets,
ec2:DeleteSubnet