subnet_tags
Expands all tag keys and values for subnets
in a region
Overview
Name | subnet_tags |
Type | Resource |
Description | Specifies a subnet for the specified VPC. For an IPv4 only subnet, specify an IPv4 CIDR block. If the VPC has an IPv6 CIDR block, you can create an IPv6 only subnet or a dual stack subnet instead. For an IPv6 only subnet, specify an IPv6 CIDR block. For a dual stack subnet, specify both an IPv4 CIDR block and an IPv6 CIDR block. For more information, see [Subnets for your VPC](https://docs.aws.amazon.com/vpc/latest/userguide/configure-subnets.html) in the *Amazon VPC User Guide*. |
Id | aws.ec2.subnet_tags |
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 .If you specify AssignIpv6AddressOnCreation , you must also specify an IPv6 CIDR block. |
vpc_id | string | The ID of the VPC the subnet is in. 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 .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/). |
enable_lni_at_device_index | integer | Indicates the device position for local network interfaces in this subnet. For example, 1 indicates local network interfaces in this subnet are the secondary network interface (eth1). |
network_acl_association_id | string | |
availability_zone | string | The Availability Zone of the subnet. 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. 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. 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*. Available options: + EnableResourceNameDnsAAAARecord (true | false) + EnableResourceNameDnsARecord (true | false) + HostnameType (ip-name | resource-name) |
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. |
tag_key | string | Tag key. |
tag_value | string | Tag value. |
region | string | AWS region. |
Methods
Name | Accessible by | Required Params |
---|---|---|
list_resources | SELECT | region |
SELECT
examples
Expands tags for all subnets
in a region.
SELECT
region,
assign_ipv6_address_on_creation,
vpc_id,
map_public_ip_on_launch,
enable_lni_at_device_index,
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,
ipv4_ipam_pool_id,
ipv4_netmask_length,
ipv6_ipam_pool_id,
ipv6_netmask_length,
tag_key,
tag_value
FROM aws.ec2.subnet_tags
WHERE region = 'us-east-1';
Permissions
For permissions required to operate on the subnet_tags
resource, see subnets