Class: Aws::EC2::Types::Subnet

Inherits:

Struct

• Object
• Struct
• Aws::EC2::Types::Subnet

Includes:

Structure

Defined in:

lib/aws-sdk-ec2/types.rb

Overview

Describes a subnet.

See Also:

• AWS API Documentation

Constant Summary

SENSITIVE =

[]

Instance Attribute Summary

• #assign_ipv_6_address_on_creation ⇒ Boolean

  Indicates whether a network interface created in this subnet (including a network interface created by RunInstances) receives an IPv6 address.

• #availability_zone ⇒ String

  The Availability Zone of the subnet.

• #availability_zone_id ⇒ String

  The AZ ID of the subnet.

• #available_ip_address_count ⇒ Integer

  The number of unused private IPv4 addresses in the subnet.

• #block_public_access_states ⇒ Types::BlockPublicAccessStates

  The state of VPC Block Public Access (BPA).

• #cidr_block ⇒ String

  The IPv4 CIDR block assigned to the subnet.

• #customer_owned_ipv_4_pool ⇒ String

  The customer-owned IPv4 address pool associated with the subnet.

• #default_for_az ⇒ Boolean

  Indicates whether this is the default subnet for the Availability Zone.

• #enable_dns_64 ⇒ Boolean

  Indicates whether DNS queries made to the Amazon-provided DNS Resolver in this subnet should return synthetic IPv6 addresses for IPv4-only destinations.

• #enable_lni_at_device_index ⇒ Integer

  Indicates the device position for local network interfaces in this subnet.

• #ipv_6_cidr_block_association_set ⇒ Array<Types::SubnetIpv6CidrBlockAssociation>

  Information about the IPv6 CIDR blocks associated with the subnet.

• #ipv_6_native ⇒ Boolean

  Indicates whether this is an IPv6 only subnet.

• #map_customer_owned_ip_on_launch ⇒ Boolean

  Indicates whether a network interface created in this subnet (including a network interface created by RunInstances) receives a customer-owned IPv4 address.

• #map_public_ip_on_launch ⇒ Boolean

  Indicates whether instances launched in this subnet receive a public IPv4 address.

• #outpost_arn ⇒ String

  The Amazon Resource Name (ARN) of the Outpost.

• #owner_id ⇒ String

  The ID of the Amazon Web Services account that owns the subnet.

• #private_dns_name_options_on_launch ⇒ Types::PrivateDnsNameOptionsOnLaunch

  The type of hostnames to assign to instances in the subnet at launch.

• #state ⇒ String

  The current state of the subnet.

• #subnet_arn ⇒ String

  The Amazon Resource Name (ARN) of the subnet.

• #subnet_id ⇒ String

  The ID of the subnet.

• #tags ⇒ Array<Types::Tag>

  Any tags assigned to the subnet.

• #vpc_id ⇒ String

  The ID of the VPC the subnet is in.

Instance Attribute Details

#assign_ipv_6_address_on_creation ⇒ Boolean

Indicates whether a network interface created in this subnet (including a network interface created by RunInstances) receives an IPv6 address.

Returns:

• (Boolean)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#availability_zone ⇒ String

The Availability Zone of the subnet.

Returns:

• (String)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#availability_zone_id ⇒ String

The AZ ID of the subnet.

Returns:

• (String)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#available_ip_address_count ⇒ Integer

The number of unused private IPv4 addresses in the subnet. The IPv4 addresses for any stopped instances are considered unavailable.

Returns:

• (Integer)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#block_public_access_states ⇒ Types::BlockPublicAccessStates

The state of VPC Block Public Access (BPA).

Returns:

• (Types::BlockPublicAccessStates)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#cidr_block ⇒ String

The IPv4 CIDR block assigned to the subnet.

Returns:

• (String)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#customer_owned_ipv_4_pool ⇒ String

The customer-owned IPv4 address pool associated with the subnet.

Returns:

• (String)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#default_for_az ⇒ Boolean

Indicates whether this is the default subnet for the Availability Zone.

Returns:

• (Boolean)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#enable_dns_64 ⇒ Boolean

Indicates whether DNS queries made to the Amazon-provided DNS Resolver in this subnet should return synthetic IPv6 addresses for IPv4-only destinations.

Returns:

• (Boolean)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

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

Returns:

• (Integer)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#ipv_6_cidr_block_association_set ⇒ Array<Types::SubnetIpv6CidrBlockAssociation>

Information about the IPv6 CIDR blocks associated with the subnet.

Returns:

• (Array<Types::SubnetIpv6CidrBlockAssociation>)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#ipv_6_native ⇒ Boolean

Indicates whether this is an IPv6 only subnet.

Returns:

• (Boolean)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#map_customer_owned_ip_on_launch ⇒ Boolean

Indicates whether a network interface created in this subnet (including a network interface created by RunInstances) receives a customer-owned IPv4 address.

Returns:

• (Boolean)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#map_public_ip_on_launch ⇒ Boolean

Indicates whether instances launched in this subnet receive a public IPv4 address.

Amazon Web Services 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 [Amazon VPC pricing page].

[1]: aws.amazon.com/vpc/pricing/

Returns:

• (Boolean)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#outpost_arn ⇒ String

The Amazon Resource Name (ARN) of the Outpost.

Returns:

• (String)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#owner_id ⇒ String

The ID of the Amazon Web Services account that owns the subnet.

Returns:

• (String)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#private_dns_name_options_on_launch ⇒ Types::PrivateDnsNameOptionsOnLaunch

The type of hostnames to assign to instances in the subnet at launch. An instance hostname is based on the IPv4 address or ID of the instance.

Returns:

• (Types::PrivateDnsNameOptionsOnLaunch)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#state ⇒ String

The current state of the subnet.

Returns:

• (String)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#subnet_arn ⇒ String

The Amazon Resource Name (ARN) of the subnet.

Returns:

• (String)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#subnet_id ⇒ String

The ID of the subnet.

Returns:

• (String)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#tags ⇒ Array<Types::Tag>

Any tags assigned to the subnet.

Returns:

• (Array<Types::Tag>)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end

#vpc_id ⇒ String

The ID of the VPC the subnet is in.

Returns:

• (String)

# File 'lib/aws-sdk-ec2/types.rb', line 68653

class Subnet < Struct.new(
  :availability_zone_id,
  :enable_lni_at_device_index,
  :map_customer_owned_ip_on_launch,
  :customer_owned_ipv_4_pool,
  :owner_id,
  :assign_ipv_6_address_on_creation,
  :ipv_6_cidr_block_association_set,
  :tags,
  :subnet_arn,
  :outpost_arn,
  :enable_dns_64,
  :ipv_6_native,
  :private_dns_name_options_on_launch,
  :block_public_access_states,
  :subnet_id,
  :state,
  :vpc_id,
  :cidr_block,
  :available_ip_address_count,
  :availability_zone,
  :default_for_az,
  :map_public_ip_on_launch)
  SENSITIVE = []
  include Aws::Structure
end