Struct NetworkInterface 

#[non_exhaustive]
pub struct NetworkInterface {

    pub access_configs: Vec<AccessConfig>,
    pub alias_ip_ranges: Vec<AliasIpRange>,
    pub fingerprint: Option<Bytes>,
    pub igmp_query: Option<IgmpQuery>,
    pub internal_ipv_6_prefix_length: Option<i32>,
    pub ipv_6_access_configs: Vec<AccessConfig>,
    pub ipv_6_access_type: Option<Ipv6AccessType>,
    pub ipv_6_address: Option<String>,
    pub kind: Option<String>,
    pub name: Option<String>,
    pub network: Option<String>,
    pub network_attachment: Option<String>,
    pub network_ip: Option<String>,
    pub nic_type: Option<NicType>,
    pub parent_nic_name: Option<String>,
    pub queue_count: Option<i32>,
    pub stack_type: Option<StackType>,
    pub subnetwork: Option<String>,
    pub vlan: Option<i32>,
    /* private fields */
}

Available on crate features instance-templates or instances or machine-images or region-instance-templates or region-instances only.

A network interface resource attached to an instance.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

access_configs: Vec<AccessConfig>

An array of configurations for this interface. Currently, only one access config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have no external internet access.

alias_ip_ranges: Vec<AliasIpRange>

An array of alias IP ranges for this network interface. You can only specify this field for network interfaces in VPC networks.

fingerprint: Option<Bytes>

Fingerprint hash of contents stored in this network interface. This field will be ignored when inserting an Instance or adding a NetworkInterface. An up-to-date fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.

igmp_query: Option<IgmpQuery>

Indicate whether igmp query is enabled on the network interface or not. If enabled, also indicates the version of IGMP supported.

internal_ipv_6_prefix_length: Option<i32>

The prefix length of the primary internal IPv6 range.

ipv_6_access_configs: Vec<AccessConfig>

An array of IPv6 access configurations for this interface. Currently, only one IPv6 access config, DIRECT_IPV6, is supported. If there is no ipv6AccessConfig specified, then this instance will have no external IPv6 Internet access.

ipv_6_access_type: Option<Ipv6AccessType>

Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be accessed from the Internet. This field is always inherited from its subnetwork.

Valid only if stackType is IPV4_IPV6.

ipv_6_address: Option<String>

An IPv6 internal network address for this network interface. To use a static internal IP address, it must be unused and in the same region as the instance’s zone. If not specified, Google Cloud will automatically assign an internal IPv6 address from the instance’s subnetwork.

kind: Option<String>

Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.

name: Option<String>

[Output Only] The name of the network interface, which is generated by the server. For a VM, the network interface uses the nicN naming format. Where N is a value between 0 and7. The default interface value is nic0.

network: Option<String>

URL of the VPC network resource for this instance. When creating an instance, if neither the network nor the subnetwork is specified, the default network global/networks/default is used. If the selected project doesn’t have the default network, you must specify a network or subnet. If the network is not specified but the subnetwork is specified, the network is inferred.

If you specify this property, you can specify the network as a full or partial URL. For example, the following are all valid URLs:

  - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
  - projects/project/global/networks/network
  - global/networks/default

network_attachment: Option<String>

The URL of the network attachment that this interface should connect to in the following format: projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.

network_ip: Option<String>

An IPv4 internal IP address to assign to the instance for this network interface. If not specified by the user, an unused internal IP is assigned by the system.

nic_type: Option<NicType>

The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet.

parent_nic_name: Option<String>

Name of the parent network interface of a dynamic network interface.

queue_count: Option<i32>

The networking queue count that’s specified by users for the network interface. Both Rx and Tx queues will be set to this number. It’ll be empty if not specified by the users.

stack_type: Option<StackType>

The stack type for this network interface. To assign only IPv4 addresses, use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.

This field can be both set at instance creation and update network interface operations.

subnetwork: Option<String>

The URL of the Subnetwork resource for this instance. If the network resource is inlegacy mode, do not specify this field. If the network is in auto subnet mode, specifying the subnetwork is optional. If the network is in custom subnet mode, specifying the subnetwork is required. If you specify this field, you can specify the subnetwork as a full or partial URL. For example, the following are all valid URLs:

  - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork

• regions/region/subnetworks/subnetwork

vlan: Option<i32>

VLAN tag of a dynamic network interface, must be an integer in the range from 2 to 255 inclusively.

Implementations

impl NetworkInterface

pub fn new() -> Self

pub fn set_access_configs<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<AccessConfig>,

Sets the value of access_configs.

Example

use google_cloud_compute_v1::model::AccessConfig;
let x = NetworkInterface::new()
    .set_access_configs([
        AccessConfig::default()/* use setters */,
        AccessConfig::default()/* use (different) setters */,
    ]);

pub fn set_alias_ip_ranges<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<AliasIpRange>,

Sets the value of alias_ip_ranges.

Example

use google_cloud_compute_v1::model::AliasIpRange;
let x = NetworkInterface::new()
    .set_alias_ip_ranges([
        AliasIpRange::default()/* use setters */,
        AliasIpRange::default()/* use (different) setters */,
    ]);

pub fn set_fingerprint<T>(self, v: T) -> Self

where T: Into<Bytes>,

Sets the value of fingerprint.

Example

let x = NetworkInterface::new().set_fingerprint(bytes::Bytes::from_static(b"example"));

pub fn set_or_clear_fingerprint<T>(self, v: Option<T>) -> Self

where T: Into<Bytes>,

Sets or clears the value of fingerprint.

Example

let x = NetworkInterface::new().set_or_clear_fingerprint(Some(bytes::Bytes::from_static(b"example")));
let x = NetworkInterface::new().set_or_clear_fingerprint(None::<bytes::Bytes>);

pub fn set_igmp_query<T>(self, v: T) -> Self

where T: Into<IgmpQuery>,

Sets the value of igmp_query.

Example

use google_cloud_compute_v1::model::network_interface::IgmpQuery;
let x0 = NetworkInterface::new().set_igmp_query(IgmpQuery::V2);

pub fn set_or_clear_igmp_query<T>(self, v: Option<T>) -> Self

where T: Into<IgmpQuery>,

Sets or clears the value of igmp_query.

Example

use google_cloud_compute_v1::model::network_interface::IgmpQuery;
let x0 = NetworkInterface::new().set_or_clear_igmp_query(Some(IgmpQuery::V2));
let x_none = NetworkInterface::new().set_or_clear_igmp_query(None::<IgmpQuery>);

pub fn set_internal_ipv_6_prefix_length<T>(self, v: T) -> Self

where T: Into<i32>,

Sets the value of internal_ipv_6_prefix_length.

Example

let x = NetworkInterface::new().set_internal_ipv_6_prefix_length(42);

pub fn set_or_clear_internal_ipv_6_prefix_length<T>(self, v: Option<T>) -> Self

where T: Into<i32>,

Sets or clears the value of internal_ipv_6_prefix_length.

Example

let x = NetworkInterface::new().set_or_clear_internal_ipv_6_prefix_length(Some(42));
let x = NetworkInterface::new().set_or_clear_internal_ipv_6_prefix_length(None::<i32>);

pub fn set_ipv_6_access_configs<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<AccessConfig>,

Sets the value of ipv_6_access_configs.

Example

use google_cloud_compute_v1::model::AccessConfig;
let x = NetworkInterface::new()
    .set_ipv_6_access_configs([
        AccessConfig::default()/* use setters */,
        AccessConfig::default()/* use (different) setters */,
    ]);

pub fn set_ipv_6_access_type<T>(self, v: T) -> Self

where T: Into<Ipv6AccessType>,

Sets the value of ipv_6_access_type.

Example

use google_cloud_compute_v1::model::network_interface::Ipv6AccessType;
let x0 = NetworkInterface::new().set_ipv_6_access_type(Ipv6AccessType::Internal);

pub fn set_or_clear_ipv_6_access_type<T>(self, v: Option<T>) -> Self

where T: Into<Ipv6AccessType>,

Sets or clears the value of ipv_6_access_type.

Example

use google_cloud_compute_v1::model::network_interface::Ipv6AccessType;
let x0 = NetworkInterface::new().set_or_clear_ipv_6_access_type(Some(Ipv6AccessType::Internal));
let x_none = NetworkInterface::new().set_or_clear_ipv_6_access_type(None::<Ipv6AccessType>);

pub fn set_ipv_6_address<T>(self, v: T) -> Self

where T: Into<String>,

Sets the value of ipv_6_address.

Example

let x = NetworkInterface::new().set_ipv_6_address("example");

pub fn set_or_clear_ipv_6_address<T>(self, v: Option<T>) -> Self

where T: Into<String>,

Sets or clears the value of ipv_6_address.

Example

let x = NetworkInterface::new().set_or_clear_ipv_6_address(Some("example"));
let x = NetworkInterface::new().set_or_clear_ipv_6_address(None::<String>);

pub fn set_kind<T>(self, v: T) -> Self

where T: Into<String>,

Sets the value of kind.

Example

let x = NetworkInterface::new().set_kind("example");

pub fn set_or_clear_kind<T>(self, v: Option<T>) -> Self

where T: Into<String>,

Sets or clears the value of kind.

Example

let x = NetworkInterface::new().set_or_clear_kind(Some("example"));
let x = NetworkInterface::new().set_or_clear_kind(None::<String>);

pub fn set_name<T>(self, v: T) -> Self

where T: Into<String>,

Sets the value of name.

Example

let x = NetworkInterface::new().set_name("example");

pub fn set_or_clear_name<T>(self, v: Option<T>) -> Self

where T: Into<String>,

Sets or clears the value of name.

Example

let x = NetworkInterface::new().set_or_clear_name(Some("example"));
let x = NetworkInterface::new().set_or_clear_name(None::<String>);

pub fn set_network<T>(self, v: T) -> Self

where T: Into<String>,

Sets the value of network.

Example

let x = NetworkInterface::new().set_network("example");

pub fn set_or_clear_network<T>(self, v: Option<T>) -> Self

where T: Into<String>,

Sets or clears the value of network.

Example

let x = NetworkInterface::new().set_or_clear_network(Some("example"));
let x = NetworkInterface::new().set_or_clear_network(None::<String>);

pub fn set_network_attachment<T>(self, v: T) -> Self

where T: Into<String>,

Sets the value of network_attachment.

Example

let x = NetworkInterface::new().set_network_attachment("example");

pub fn set_or_clear_network_attachment<T>(self, v: Option<T>) -> Self

where T: Into<String>,

Sets or clears the value of network_attachment.

Example

let x = NetworkInterface::new().set_or_clear_network_attachment(Some("example"));
let x = NetworkInterface::new().set_or_clear_network_attachment(None::<String>);

pub fn set_network_ip<T>(self, v: T) -> Self

where T: Into<String>,

Sets the value of network_ip.

Example

let x = NetworkInterface::new().set_network_ip("example");

pub fn set_or_clear_network_ip<T>(self, v: Option<T>) -> Self

where T: Into<String>,

Sets or clears the value of network_ip.

Example

let x = NetworkInterface::new().set_or_clear_network_ip(Some("example"));
let x = NetworkInterface::new().set_or_clear_network_ip(None::<String>);

pub fn set_nic_type<T>(self, v: T) -> Self

where T: Into<NicType>,

Sets the value of nic_type.

Example

use google_cloud_compute_v1::model::network_interface::NicType;
let x0 = NetworkInterface::new().set_nic_type(NicType::Idpf);
let x1 = NetworkInterface::new().set_nic_type(NicType::Irdma);
let x2 = NetworkInterface::new().set_nic_type(NicType::Mrdma);

pub fn set_or_clear_nic_type<T>(self, v: Option<T>) -> Self

where T: Into<NicType>,

Sets or clears the value of nic_type.

Example

use google_cloud_compute_v1::model::network_interface::NicType;
let x0 = NetworkInterface::new().set_or_clear_nic_type(Some(NicType::Idpf));
let x1 = NetworkInterface::new().set_or_clear_nic_type(Some(NicType::Irdma));
let x2 = NetworkInterface::new().set_or_clear_nic_type(Some(NicType::Mrdma));
let x_none = NetworkInterface::new().set_or_clear_nic_type(None::<NicType>);

pub fn set_parent_nic_name<T>(self, v: T) -> Self

where T: Into<String>,

Sets the value of parent_nic_name.

Example

let x = NetworkInterface::new().set_parent_nic_name("example");

pub fn set_or_clear_parent_nic_name<T>(self, v: Option<T>) -> Self

where T: Into<String>,

Sets or clears the value of parent_nic_name.

Example

let x = NetworkInterface::new().set_or_clear_parent_nic_name(Some("example"));
let x = NetworkInterface::new().set_or_clear_parent_nic_name(None::<String>);

pub fn set_queue_count<T>(self, v: T) -> Self

where T: Into<i32>,

Sets the value of queue_count.

Example

let x = NetworkInterface::new().set_queue_count(42);

pub fn set_or_clear_queue_count<T>(self, v: Option<T>) -> Self

where T: Into<i32>,

Sets or clears the value of queue_count.

Example

let x = NetworkInterface::new().set_or_clear_queue_count(Some(42));
let x = NetworkInterface::new().set_or_clear_queue_count(None::<i32>);

pub fn set_stack_type<T>(self, v: T) -> Self

where T: Into<StackType>,

Sets the value of stack_type.

Example

use google_cloud_compute_v1::model::network_interface::StackType;
let x0 = NetworkInterface::new().set_stack_type(StackType::Ipv4Only);
let x1 = NetworkInterface::new().set_stack_type(StackType::Ipv6Only);

pub fn set_or_clear_stack_type<T>(self, v: Option<T>) -> Self

where T: Into<StackType>,

Sets or clears the value of stack_type.

Example

use google_cloud_compute_v1::model::network_interface::StackType;
let x0 = NetworkInterface::new().set_or_clear_stack_type(Some(StackType::Ipv4Only));
let x1 = NetworkInterface::new().set_or_clear_stack_type(Some(StackType::Ipv6Only));
let x_none = NetworkInterface::new().set_or_clear_stack_type(None::<StackType>);

pub fn set_subnetwork<T>(self, v: T) -> Self

where T: Into<String>,

Sets the value of subnetwork.

Example

let x = NetworkInterface::new().set_subnetwork("example");

pub fn set_or_clear_subnetwork<T>(self, v: Option<T>) -> Self

where T: Into<String>,

Sets or clears the value of subnetwork.

Example

let x = NetworkInterface::new().set_or_clear_subnetwork(Some("example"));
let x = NetworkInterface::new().set_or_clear_subnetwork(None::<String>);

pub fn set_vlan<T>(self, v: T) -> Self

where T: Into<i32>,

Sets the value of vlan.

Example

let x = NetworkInterface::new().set_vlan(42);

pub fn set_or_clear_vlan<T>(self, v: Option<T>) -> Self

where T: Into<i32>,

Sets or clears the value of vlan.

Example

let x = NetworkInterface::new().set_or_clear_vlan(Some(42));
let x = NetworkInterface::new().set_or_clear_vlan(None::<i32>);

Trait Implementations

impl Clone for NetworkInterface

fn clone(&self) -> NetworkInterface

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NetworkInterface

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for NetworkInterface

fn default() -> NetworkInterface

Returns the “default value” for a type.

impl Message for NetworkInterface

fn typename() -> &'static str

The typename of this message.

impl PartialEq for NetworkInterface

fn eq(&self, other: &NetworkInterface) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for NetworkInterface