Skip to content

EC2  >  Operations  >  modify_subnet_attribute

modify_subnet_attribute

Operation

modify_subnet_attribute async 

modify_subnet_attribute(input: ModifySubnetAttributeInput, plugins: list[Plugin] | None = None) -> ModifySubnetAttributeOutput

Modifies a subnet attribute. You can only modify one attribute at a time.

Use this action to modify subnets on Amazon Web Services Outposts.

  • To modify a subnet on an Outpost rack, set both MapCustomerOwnedIpOnLaunch and CustomerOwnedIpv4Pool. These two parameters act as a single attribute.

  • To modify a subnet on an Outpost server, set either EnableLniAtDeviceIndex or DisableLniAtDeviceIndex.

For more information about Amazon Web Services Outposts, see the following:

Parameters:

Name Type Description Default
input ModifySubnetAttributeInput

An instance of ModifySubnetAttributeInput.

 required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

 None

Returns:

Type Description
ModifySubnetAttributeOutput

An instance of ModifySubnetAttributeOutput.

Input

ModifySubnetAttributeInput dataclass

Bases: _SerdeShape

Dataclass for ModifySubnetAttributeInput structure.

Attributes

assign_ipv6_address_on_creation class-attribute instance-attribute 
assign_ipv6_address_on_creation: AttributeBooleanValue | None = ...

Specify true to indicate that network interfaces created in the specified subnet should be assigned an IPv6 address. This includes a network interface that's created when launching an instance into the subnet (the instance therefore receives an IPv6 address).

If you enable the IPv6 addressing feature for your subnet, your network interface or instance only receives an IPv6 address if it's created using version 2016-11-15 or later of the Amazon EC2 API.

customer_owned_ipv4_pool class-attribute instance-attribute 
customer_owned_ipv4_pool: str | None = ...

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

You must set this value when you specify true for MapCustomerOwnedIpOnLaunch.

disable_lni_at_device_index class-attribute instance-attribute 
disable_lni_at_device_index: AttributeBooleanValue | None = ...

Specify true to indicate that local network interfaces at the current position should be disabled.

enable_dns64 class-attribute instance-attribute 
enable_dns64: AttributeBooleanValue | None = ...

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

You must first configure a NAT gateway in a public subnet (separate from the subnet containing the IPv6-only workloads). For example, the subnet containing the NAT gateway should have a 0.0.0.0/0 route pointing to the internet gateway. For more information, see Configure DNS64 and NAT64 in the Amazon VPC User Guide.

enable_lni_at_device_index class-attribute instance-attribute 
enable_lni_at_device_index: int | None = ...

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). A local network interface cannot be the primary network interface (eth0).

enable_resource_name_dns_a_record_on_launch class-attribute instance-attribute 
enable_resource_name_dns_a_record_on_launch: AttributeBooleanValue | None = ...

Indicates whether to respond to DNS queries for instance hostnames with DNS A records.

enable_resource_name_dns_aaaa_record_on_launch class-attribute instance-attribute 
enable_resource_name_dns_aaaa_record_on_launch: AttributeBooleanValue | None = ...

Indicates whether to respond to DNS queries for instance hostnames with DNS AAAA records.

map_customer_owned_ip_on_launch class-attribute instance-attribute 
map_customer_owned_ip_on_launch: AttributeBooleanValue | None = ...

Specify true to indicate that network interfaces attached to instances created in the specified subnet should be assigned a customer-owned IPv4 address.

When this value is true, you must specify the customer-owned IP pool using CustomerOwnedIpv4Pool.

map_public_ip_on_launch class-attribute instance-attribute 
map_public_ip_on_launch: AttributeBooleanValue | None = ...

Specify true to indicate that network interfaces attached to instances created in the specified subnet should be assigned 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.

private_dns_hostname_type_on_launch class-attribute instance-attribute 
private_dns_hostname_type_on_launch: str | None = ...

The type of hostname to assign to instances in the subnet at launch. For IPv4-only and dual-stack (IPv4 and IPv6) subnets, an instance DNS name can be based on the instance IPv4 address (ip-name) or the instance ID (resource-name). For IPv6 only subnets, an instance DNS name must be based on the instance ID (resource-name).

subnet_id class-attribute instance-attribute 
subnet_id: str | None = ...

The ID of the subnet.

Output

ModifySubnetAttributeOutput dataclass

Bases: _SerdeShape

Dataclass for ModifySubnetAttributeOutput structure.

Attributes

response_metadata class-attribute instance-attribute 
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.