subnetworks_usable

Creates, updates, deletes, gets or lists a subnetworks_usable resource.

Overview

Name	subnetworks_usable
Type	Resource
Id	google.compute.subnetworks_usable

Fields

Name	Datatype	Description
externalIpv6Prefix	string	[Output Only] The external IPv6 address range that is assigned to this subnetwork.
internalIpv6Prefix	string	[Output Only] The internal IPv6 address range that is assigned to this subnetwork.
ipCidrRange	string	The range of internal addresses that are owned by this subnetwork.
ipv6AccessType	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.
network	string	Network URL.
purpose	string	The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.
role	string	The role of subnetwork. Currently, this field is only used when purpose is set to GLOBAL_MANAGED_PROXY or 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. This field can be updated with a patch request.
secondaryIpRanges	array	Secondary IP ranges.
stackType	string	The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and IPv6 addresses. If not specified, IPV4_ONLY is used. This field can be both set at resource creation time and updated using patch.
subnetwork	string	Subnetwork URL.

Methods

Name	Accessible by	Required Params	Description
list_usable	SELECT	project	Retrieves an aggregated list of all usable subnetworks in the project.

SELECT examples

Retrieves an aggregated list of all usable subnetworks in the project.

SELECT
externalIpv6Prefix,
internalIpv6Prefix,
ipCidrRange,
ipv6AccessType,
network,
purpose,
role,
secondaryIpRanges,
stackType,
subnetwork
FROM google.compute.subnetworks_usable
WHERE project = '{{ project }}';