#[non_exhaustive]pub struct InstanceNetworkInterfaceSpecification {Show 23 fields
pub associate_public_ip_address: Option<bool>,
pub delete_on_termination: Option<bool>,
pub description: Option<String>,
pub device_index: Option<i32>,
pub groups: Option<Vec<String>>,
pub ipv6_address_count: Option<i32>,
pub ipv6_addresses: Option<Vec<InstanceIpv6Address>>,
pub network_interface_id: Option<String>,
pub private_ip_address: Option<String>,
pub private_ip_addresses: Option<Vec<PrivateIpAddressSpecification>>,
pub secondary_private_ip_address_count: Option<i32>,
pub subnet_id: Option<String>,
pub associate_carrier_ip_address: Option<bool>,
pub interface_type: Option<String>,
pub network_card_index: Option<i32>,
pub ipv4_prefixes: Option<Vec<Ipv4PrefixSpecificationRequest>>,
pub ipv4_prefix_count: Option<i32>,
pub ipv6_prefixes: Option<Vec<Ipv6PrefixSpecificationRequest>>,
pub ipv6_prefix_count: Option<i32>,
pub primary_ipv6: Option<bool>,
pub ena_srd_specification: Option<EnaSrdSpecificationRequest>,
pub connection_tracking_specification: Option<ConnectionTrackingSpecificationRequest>,
pub ena_queue_count: Option<i32>,
}Expand description
Describes a network interface.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.associate_public_ip_address: Option<bool>Indicates whether to assign a public IPv4 address to an instance you launch in a VPC. The public IP address can only be assigned to a network interface for eth0, and can only be assigned to a new network interface, not an existing one. You cannot specify more than one network interface in the request. If launching into a default subnet, the default value is true.
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.
delete_on_termination: Option<bool>If set to true, the interface is deleted when the instance is terminated. You can specify true only if creating a new network interface when launching an instance.
description: Option<String>The description of the network interface. Applies only if creating a network interface when launching an instance.
device_index: Option<i32>The position of the network interface in the attachment order. A primary network interface has a device index of 0.
If you specify a network interface when launching an instance, you must specify the device index.
groups: Option<Vec<String>>The IDs of the security groups for the network interface. Applies only if creating a network interface when launching an instance.
ipv6_address_count: Option<i32>A number of IPv6 addresses to assign to the network interface. Amazon EC2 chooses the IPv6 addresses from the range of the subnet. You cannot specify this option and the option to assign specific IPv6 addresses in the same request. You can specify this option if you've specified a minimum number of instances to launch.
ipv6_addresses: Option<Vec<InstanceIpv6Address>>The IPv6 addresses to assign to the network interface. You cannot specify this option and the option to assign a number of IPv6 addresses in the same request. You cannot specify this option if you've specified a minimum number of instances to launch.
network_interface_id: Option<String>The ID of the network interface.
If you are creating a Spot Fleet, omit this parameter because you can’t specify a network interface ID in a launch specification.
private_ip_address: Option<String>The private IPv4 address of the network interface. Applies only if creating a network interface when launching an instance. You cannot specify this option if you're launching more than one instance in a RunInstances request.
private_ip_addresses: Option<Vec<PrivateIpAddressSpecification>>The private IPv4 addresses to assign to the network interface. Only one private IPv4 address can be designated as primary. You cannot specify this option if you're launching more than one instance in a RunInstances request.
secondary_private_ip_address_count: Option<i32>The number of secondary private IPv4 addresses. You can’t specify this parameter and also specify a secondary private IP address using the PrivateIpAddress parameter.
subnet_id: Option<String>The ID of the subnet associated with the network interface. Applies only if creating a network interface when launching an instance.
associate_carrier_ip_address: Option<bool>Indicates whether to assign a carrier IP address to the network interface.
You can only assign a carrier IP address to a network interface that is in a subnet in a Wavelength Zone. For more information about carrier IP addresses, see Carrier IP address in the Amazon Web Services Wavelength Developer Guide.
interface_type: Option<String>The type of network interface.
If you specify efa-only, do not assign any IP addresses to the network interface. EFA-only network interfaces do not support IP addresses.
Valid values: interface | efa | efa-only
network_card_index: Option<i32>The index of the network card. Some instance types support multiple network cards. The primary network interface must be assigned to network card index 0. The default is network card index 0.
If you are using RequestSpotInstances to create Spot Instances, omit this parameter because you can’t specify the network card index when using this API. To specify the network card index, use RunInstances.
ipv4_prefixes: Option<Vec<Ipv4PrefixSpecificationRequest>>The IPv4 delegated prefixes to be assigned to the network interface. You cannot use this option if you use the Ipv4PrefixCount option.
ipv4_prefix_count: Option<i32>The number of IPv4 delegated prefixes to be automatically assigned to the network interface. You cannot use this option if you use the Ipv4Prefix option.
ipv6_prefixes: Option<Vec<Ipv6PrefixSpecificationRequest>>The IPv6 delegated prefixes to be assigned to the network interface. You cannot use this option if you use the Ipv6PrefixCount option.
ipv6_prefix_count: Option<i32>The number of IPv6 delegated prefixes to be automatically assigned to the network interface. You cannot use this option if you use the Ipv6Prefix option.
primary_ipv6: Option<bool>The primary IPv6 address of the network interface. When you enable an IPv6 GUA address to be a primary IPv6, the first IPv6 GUA will be made the primary IPv6 address until the instance is terminated or the network interface is detached. For more information about primary IPv6 addresses, see RunInstances.
ena_srd_specification: Option<EnaSrdSpecificationRequest>Specifies the ENA Express settings for the network interface that's attached to the instance.
connection_tracking_specification: Option<ConnectionTrackingSpecificationRequest>A security group connection tracking specification that enables you to set the timeout for connection tracking on an Elastic network interface. For more information, see Connection tracking timeouts in the Amazon EC2 User Guide.
ena_queue_count: Option<i32>The number of ENA queues to be created with the instance.
Implementations§
Source§impl InstanceNetworkInterfaceSpecification
impl InstanceNetworkInterfaceSpecification
Sourcepub fn associate_public_ip_address(&self) -> Option<bool>
pub fn associate_public_ip_address(&self) -> Option<bool>
Indicates whether to assign a public IPv4 address to an instance you launch in a VPC. The public IP address can only be assigned to a network interface for eth0, and can only be assigned to a new network interface, not an existing one. You cannot specify more than one network interface in the request. If launching into a default subnet, the default value is true.
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.
Sourcepub fn delete_on_termination(&self) -> Option<bool>
pub fn delete_on_termination(&self) -> Option<bool>
If set to true, the interface is deleted when the instance is terminated. You can specify true only if creating a new network interface when launching an instance.
Sourcepub fn description(&self) -> Option<&str>
pub fn description(&self) -> Option<&str>
The description of the network interface. Applies only if creating a network interface when launching an instance.
Sourcepub fn device_index(&self) -> Option<i32>
pub fn device_index(&self) -> Option<i32>
The position of the network interface in the attachment order. A primary network interface has a device index of 0.
If you specify a network interface when launching an instance, you must specify the device index.
Sourcepub fn groups(&self) -> &[String]
pub fn groups(&self) -> &[String]
The IDs of the security groups for the network interface. Applies only if creating a network interface when launching an instance.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .groups.is_none().
Sourcepub fn ipv6_address_count(&self) -> Option<i32>
pub fn ipv6_address_count(&self) -> Option<i32>
A number of IPv6 addresses to assign to the network interface. Amazon EC2 chooses the IPv6 addresses from the range of the subnet. You cannot specify this option and the option to assign specific IPv6 addresses in the same request. You can specify this option if you've specified a minimum number of instances to launch.
Sourcepub fn ipv6_addresses(&self) -> &[InstanceIpv6Address]
pub fn ipv6_addresses(&self) -> &[InstanceIpv6Address]
The IPv6 addresses to assign to the network interface. You cannot specify this option and the option to assign a number of IPv6 addresses in the same request. You cannot specify this option if you've specified a minimum number of instances to launch.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .ipv6_addresses.is_none().
Sourcepub fn network_interface_id(&self) -> Option<&str>
pub fn network_interface_id(&self) -> Option<&str>
The ID of the network interface.
If you are creating a Spot Fleet, omit this parameter because you can’t specify a network interface ID in a launch specification.
Sourcepub fn private_ip_address(&self) -> Option<&str>
pub fn private_ip_address(&self) -> Option<&str>
The private IPv4 address of the network interface. Applies only if creating a network interface when launching an instance. You cannot specify this option if you're launching more than one instance in a RunInstances request.
Sourcepub fn private_ip_addresses(&self) -> &[PrivateIpAddressSpecification]
pub fn private_ip_addresses(&self) -> &[PrivateIpAddressSpecification]
The private IPv4 addresses to assign to the network interface. Only one private IPv4 address can be designated as primary. You cannot specify this option if you're launching more than one instance in a RunInstances request.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .private_ip_addresses.is_none().
Sourcepub fn secondary_private_ip_address_count(&self) -> Option<i32>
pub fn secondary_private_ip_address_count(&self) -> Option<i32>
The number of secondary private IPv4 addresses. You can’t specify this parameter and also specify a secondary private IP address using the PrivateIpAddress parameter.
Sourcepub fn subnet_id(&self) -> Option<&str>
pub fn subnet_id(&self) -> Option<&str>
The ID of the subnet associated with the network interface. Applies only if creating a network interface when launching an instance.
Sourcepub fn associate_carrier_ip_address(&self) -> Option<bool>
pub fn associate_carrier_ip_address(&self) -> Option<bool>
Indicates whether to assign a carrier IP address to the network interface.
You can only assign a carrier IP address to a network interface that is in a subnet in a Wavelength Zone. For more information about carrier IP addresses, see Carrier IP address in the Amazon Web Services Wavelength Developer Guide.
Sourcepub fn interface_type(&self) -> Option<&str>
pub fn interface_type(&self) -> Option<&str>
The type of network interface.
If you specify efa-only, do not assign any IP addresses to the network interface. EFA-only network interfaces do not support IP addresses.
Valid values: interface | efa | efa-only
Sourcepub fn network_card_index(&self) -> Option<i32>
pub fn network_card_index(&self) -> Option<i32>
The index of the network card. Some instance types support multiple network cards. The primary network interface must be assigned to network card index 0. The default is network card index 0.
If you are using RequestSpotInstances to create Spot Instances, omit this parameter because you can’t specify the network card index when using this API. To specify the network card index, use RunInstances.
Sourcepub fn ipv4_prefixes(&self) -> &[Ipv4PrefixSpecificationRequest]
pub fn ipv4_prefixes(&self) -> &[Ipv4PrefixSpecificationRequest]
The IPv4 delegated prefixes to be assigned to the network interface. You cannot use this option if you use the Ipv4PrefixCount option.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .ipv4_prefixes.is_none().
Sourcepub fn ipv4_prefix_count(&self) -> Option<i32>
pub fn ipv4_prefix_count(&self) -> Option<i32>
The number of IPv4 delegated prefixes to be automatically assigned to the network interface. You cannot use this option if you use the Ipv4Prefix option.
Sourcepub fn ipv6_prefixes(&self) -> &[Ipv6PrefixSpecificationRequest]
pub fn ipv6_prefixes(&self) -> &[Ipv6PrefixSpecificationRequest]
The IPv6 delegated prefixes to be assigned to the network interface. You cannot use this option if you use the Ipv6PrefixCount option.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .ipv6_prefixes.is_none().
Sourcepub fn ipv6_prefix_count(&self) -> Option<i32>
pub fn ipv6_prefix_count(&self) -> Option<i32>
The number of IPv6 delegated prefixes to be automatically assigned to the network interface. You cannot use this option if you use the Ipv6Prefix option.
Sourcepub fn primary_ipv6(&self) -> Option<bool>
pub fn primary_ipv6(&self) -> Option<bool>
The primary IPv6 address of the network interface. When you enable an IPv6 GUA address to be a primary IPv6, the first IPv6 GUA will be made the primary IPv6 address until the instance is terminated or the network interface is detached. For more information about primary IPv6 addresses, see RunInstances.
Sourcepub fn ena_srd_specification(&self) -> Option<&EnaSrdSpecificationRequest>
pub fn ena_srd_specification(&self) -> Option<&EnaSrdSpecificationRequest>
Specifies the ENA Express settings for the network interface that's attached to the instance.
Sourcepub fn connection_tracking_specification(
&self,
) -> Option<&ConnectionTrackingSpecificationRequest>
pub fn connection_tracking_specification( &self, ) -> Option<&ConnectionTrackingSpecificationRequest>
A security group connection tracking specification that enables you to set the timeout for connection tracking on an Elastic network interface. For more information, see Connection tracking timeouts in the Amazon EC2 User Guide.
Sourcepub fn ena_queue_count(&self) -> Option<i32>
pub fn ena_queue_count(&self) -> Option<i32>
The number of ENA queues to be created with the instance.
Source§impl InstanceNetworkInterfaceSpecification
impl InstanceNetworkInterfaceSpecification
Sourcepub fn builder() -> InstanceNetworkInterfaceSpecificationBuilder
pub fn builder() -> InstanceNetworkInterfaceSpecificationBuilder
Creates a new builder-style object to manufacture InstanceNetworkInterfaceSpecification.
Trait Implementations§
Source§impl Clone for InstanceNetworkInterfaceSpecification
impl Clone for InstanceNetworkInterfaceSpecification
Source§fn clone(&self) -> InstanceNetworkInterfaceSpecification
fn clone(&self) -> InstanceNetworkInterfaceSpecification
1.0.0 · Source§const fn clone_from(&mut self, source: &Self)
const fn clone_from(&mut self, source: &Self)
source. Read moreSource§impl PartialEq for InstanceNetworkInterfaceSpecification
impl PartialEq for InstanceNetworkInterfaceSpecification
Source§fn eq(&self, other: &InstanceNetworkInterfaceSpecification) -> bool
fn eq(&self, other: &InstanceNetworkInterfaceSpecification) -> bool
self and other values to be equal, and is used by ==.impl StructuralPartialEq for InstanceNetworkInterfaceSpecification
Auto Trait Implementations§
impl Freeze for InstanceNetworkInterfaceSpecification
impl RefUnwindSafe for InstanceNetworkInterfaceSpecification
impl Send for InstanceNetworkInterfaceSpecification
impl Sync for InstanceNetworkInterfaceSpecification
impl Unpin for InstanceNetworkInterfaceSpecification
impl UnwindSafe for InstanceNetworkInterfaceSpecification
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere
T: ?Sized,
Source§fn fg(&self, value: Color) -> Painted<&T>
fn fg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self with the foreground set to
value.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like red() and
green(), which have the same functionality but are
pithier.
§Example
Set foreground color to white using fg():
use yansi::{Paint, Color};
painted.fg(Color::White);Set foreground color to white using white().
use yansi::Paint;
painted.white();Source§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
Source§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
Source§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
Source§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
Source§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
Source§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
Source§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
Source§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
Source§fn bg(&self, value: Color) -> Painted<&T>
fn bg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self with the background set to
value.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like on_red() and
on_green(), which have the same functionality but
are pithier.
§Example
Set background color to red using fg():
use yansi::{Paint, Color};
painted.bg(Color::Red);Set background color to red using on_red().
use yansi::Paint;
painted.on_red();Source§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
Source§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
Source§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
Source§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
Source§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
Source§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
Source§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
Source§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
Source§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
Source§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
Source§fn attr(&self, value: Attribute) -> Painted<&T>
fn attr(&self, value: Attribute) -> Painted<&T>
Enables the styling Attribute value.
This method should be used rarely. Instead, prefer to use
attribute-specific builder methods like bold() and
underline(), which have the same functionality
but are pithier.
§Example
Make text bold using attr():
use yansi::{Paint, Attribute};
painted.attr(Attribute::Bold);Make text bold using using bold().
use yansi::Paint;
painted.bold();Source§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
Source§fn quirk(&self, value: Quirk) -> Painted<&T>
fn quirk(&self, value: Quirk) -> Painted<&T>
Enables the yansi Quirk value.
This method should be used rarely. Instead, prefer to use quirk-specific
builder methods like mask() and
wrap(), which have the same functionality but are
pithier.
§Example
Enable wrapping using .quirk():
use yansi::{Paint, Quirk};
painted.quirk(Quirk::Wrap);Enable wrapping using wrap().
use yansi::Paint;
painted.wrap();Source§fn clear(&self) -> Painted<&T>
👎Deprecated since 1.0.1: renamed to resetting() due to conflicts with Vec::clear().
The clear() method will be removed in a future release.
fn clear(&self) -> Painted<&T>
resetting() due to conflicts with Vec::clear().
The clear() method will be removed in a future release.Source§fn whenever(&self, value: Condition) -> Painted<&T>
fn whenever(&self, value: Condition) -> Painted<&T>
Conditionally enable styling based on whether the Condition value
applies. Replaces any previous condition.
See the crate level docs for more details.
§Example
Enable styling painted only when both stdout and stderr are TTYs:
use yansi::{Paint, Condition};
painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);