Struct SubnetworkArgs

pub struct SubnetworkArgs {

    pub allow_subnet_cidr_routes_overlap: Output<Option<bool>>,
    pub description: Output<Option<String>>,
    pub external_ipv6_prefix: Output<Option<String>>,
    pub ip_cidr_range: Output<Option<String>>,
    pub ipv6_access_type: Output<Option<String>>,
    pub log_config: Output<Option<SubnetworkLogConfig>>,
    pub name: Output<Option<String>>,
    pub network: Output<String>,
    pub private_ip_google_access: Output<Option<bool>>,
    pub private_ipv6_google_access: Output<Option<String>>,
    pub project: Output<Option<String>>,
    pub purpose: Output<Option<String>>,
    pub region: Output<Option<String>>,
    pub reserved_internal_range: Output<Option<String>>,
    pub role: Output<Option<String>>,
    pub secondary_ip_ranges: Output<Option<Vec<SubnetworkSecondaryIpRange>>>,
    pub send_secondary_ip_range_if_empty: Output<Option<bool>>,
    pub stack_type: Output<Option<String>>,
}

Fields

allow_subnet_cidr_routes_overlap: Output<Option<bool>>

Typically packets destined to IPs within the subnetwork range that do not match existing resources are dropped and prevented from leaving the VPC. Setting this field to true will allow these packets to match dynamic routes injected via BGP even if their destinations match existing subnet ranges.

description: Output<Option<String>>

An optional description of this resource. Provide this property when you create the resource. This field can be set only at resource creation time.

external_ipv6_prefix: Output<Option<String>>

The range of external IPv6 addresses that are owned by this subnetwork.

ip_cidr_range: Output<Option<String>>

The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 192.168.0.0/16. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. Field is optional when reserved_internal_range is defined, otherwise required.

ipv6_access_type: Output<Option<String>>

The access type of IPv6 address this subnet holds. It’s immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack. If the ipv6_type is EXTERNAL then this subnet cannot enable direct path. Possible values are: EXTERNAL, INTERNAL.

log_config: Output<Option<SubnetworkLogConfig>>

This field denotes the VPC flow logging options for this subnetwork. If logging is enabled, logs are exported to Cloud Logging. Flow logging isn’t supported if the subnet purpose field is set to subnetwork is REGIONAL_MANAGED_PROXY or GLOBAL_MANAGED_PROXY. Structure is documented below.

name: Output<Option<String>>

The name of the resource, provided by the client when initially creating the resource. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression a-z? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.

network: Output<String>

The network this subnet belongs to. Only networks that are in the distributed mode can have subnetworks.

---

private_ip_google_access: Output<Option<bool>>

When enabled, VMs in this subnetwork without external IP addresses can access Google APIs and services by using Private Google Access.

private_ipv6_google_access: Output<Option<String>>

The private IPv6 google access type for the VMs in this subnet.

project: Output<Option<String>>

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

purpose: Output<Option<String>>

The purpose of the resource. This field can be either PRIVATE, REGIONAL_MANAGED_PROXY, GLOBAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT or PRIVATE_NAT. A subnet with purpose set to REGIONAL_MANAGED_PROXY is a user-created subnetwork that is reserved for regional Envoy-based load balancers. A subnetwork in a given region with purpose set to GLOBAL_MANAGED_PROXY is a proxy-only subnet and is shared between all the cross-regional Envoy-based load balancers. A subnetwork with purpose set to PRIVATE_SERVICE_CONNECT reserves the subnet for hosting a Private Service Connect published service. A subnetwork with purpose set to PRIVATE_NAT is used as source range for Private NAT gateways. Note that REGIONAL_MANAGED_PROXY is the preferred setting for all regional Envoy load balancers. If unspecified, the purpose defaults to PRIVATE.

region: Output<Option<String>>

The GCP region for this subnetwork.

reserved_internal_range: Output<Option<String>>

The ID of the reserved internal range. Must be prefixed with networkconnectivity.googleapis.com E.g. networkconnectivity.googleapis.com/projects/{project}/locations/global/internalRanges/{rangeId}

role: Output<Option<String>>

The role of subnetwork. Currently, this field is only used when purpose is REGIONAL_MANAGED_PROXY. The value can be set to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being used for Envoy-based load balancers in a region. A BACKUP subnetwork is one that is ready to be promoted to ACTIVE or is currently draining. Possible values are: ACTIVE, BACKUP.

secondary_ip_ranges: Output<Option<Vec<SubnetworkSecondaryIpRange>>>

An array of configurations for secondary IP ranges for VM instances contained in this subnetwork. The primary IP of such VM must belong to the primary ipCidrRange of the subnetwork. The alias IPs may belong to either primary or secondary ranges. Structure is documented below.

send_secondary_ip_range_if_empty: Output<Option<bool>>

Controls the removal behavior of secondary_ip_range. When false, removing secondary_ip_range from config will not produce a diff as the provider will default to the API’s value. When true, the provider will treat removing secondary_ip_range as sending an empty list of secondary IP ranges to the API. Defaults to false.

stack_type: Output<Option<String>>

The stack type for this subnet to identify whether the IPv6 feature is enabled or not. If not specified IPV4_ONLY will be used. Possible values are: IPV4_ONLY, IPV4_IPV6.

Implementations

impl SubnetworkArgs

pub fn builder() -> SubnetworkArgsBuilder

Create an instance of SubnetworkArgs using the builder syntax

Trait Implementations

impl Clone for SubnetworkArgs

fn clone(&self) -> SubnetworkArgs

Returns a copy of the value.

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

Performs copy-assignment from source.