SubnetworkArgs class
The set of arguments for Subnetwork. The set of arguments for Subnetwork.
Constructors
-
SubnetworkArgs({Input<
bool?> ? allowSubnetCidrRoutesOverlap, Input<String?> ? deletionPolicy, Input<String?> ? description, Input<String?> ? externalIpv6Prefix, Input<String?> ? internalIpv6Prefix, Input<String?> ? ipCidrRange, Input<String?> ? ipCollection, Input<String?> ? ipv6AccessType, Input<SubnetworkLogConfig?> ? logConfig, Input<String?> ? name, required Input<String> network, Input<SubnetworkParams?> ? params, Input<bool?> ? privateIpGoogleAccess, Input<String?> ? privateIpv6GoogleAccess, Input<String?> ? project, Input<String?> ? purpose, Input<String?> ? region, Input<String?> ? reservedInternalRange, Input<String?> ? resolveSubnetMask, Input<String?> ? role, Input<List< ? secondaryIpRanges, Input<SubnetworkSecondaryIpRange> ?>bool?> ? sendSecondaryIpRangeIfEmpty, Input<String?> ? stackType}) -
Creates a new SubnetworkArgs.
allowSubnetCidrRoutesOverlapTypically packets destined to IPs within the subnetwork range that do not matchdeletionPolicyWhether Terraform will be prevented from destroying the resource. Defaults to DELETE.descriptionAn optional description of this resource. Provide this property whenexternalIpv6PrefixThe range of external IPv6 addresses that are owned by this subnetwork.internalIpv6PrefixThe internal IPv6 address range that is assigned to this subnetwork.ipCidrRangeThe range of internal addresses that are owned by this subnetwork.ipCollectionResource reference of a PublicDelegatedPrefix. The PDP must be a sub-PDPipv6AccessTypeThe access type of IPv6 address this subnet holds. It's immutable and can only be specified during creationlogConfigThis field denotes the VPC flow logging options for this subnetwork. IfnameThe name of the resource, provided by the client when initiallynetworkThe network this subnet belongs to.paramsAdditional params passed with the request, but not persisted as part of resource payloadprivateIpGoogleAccessWhen enabled, VMs in this subnetwork without external IP addresses canprivateIpv6GoogleAccessThe private IPv6 google access type for the VMs in this subnet.projectThe ID of the project in which the resource belongs.purposeThe purpose of the resource. This field can be eitherPRIVATE,REGIONAL_MANAGED_PROXY,GLOBAL_MANAGED_PROXY,PRIVATE_SERVICE_CONNECT,PEER_MIGRATIONorPRIVATE_NAT(Beta).regionThe GCP region for this subnetwork.reservedInternalRangeThe ID of the reserved internal range. Must be prefixed withnetworkconnectivity.googleapis.comresolveSubnetMask'Configures subnet mask resolution for this subnetwork.'roleThe role of subnetwork.secondaryIpRangesAn array of configurations for secondary IP ranges for VM instancessendSecondaryIpRangeIfEmptyControls the removal behavior of secondary_ip_range.stackTypeThe stack type for this subnet to identify whether the IPv6 feature is enabled or not.const -
SubnetworkArgs.fromMap(Map<
String, dynamic> map) -
factory
Properties
-
allowSubnetCidrRoutesOverlap
→ Input<
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.
final
-
deletionPolicy
→ Input<
String?> ? -
Whether Terraform will be prevented from destroying the resource. Defaults to DELETE.
When a 'terraform destroy' or 'pulumi up' would delete the resource,
the command will fail if this field is set to "PREVENT" in Terraform state.
When set to "ABANDON", the command will remove the resource from Terraform
management without updating or deleting the resource in the API.
When set to "DELETE", deleting the resource is allowed.
final
-
description
→ Input<
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.
final
-
externalIpv6Prefix
→ Input<
String?> ? -
The range of external IPv6 addresses that are owned by this subnetwork.
final
- hashCode → int
-
The hash code for this object.
no setterinherited
-
internalIpv6Prefix
→ Input<
String?> ? -
The internal IPv6 address range that is assigned to this subnetwork.
final
-
ipCidrRange
→ Input<
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
reservedInternalRangeis defined, otherwise required.final -
ipCollection
→ Input<
String?> ? -
Resource reference of a PublicDelegatedPrefix. The PDP must be a sub-PDP
in EXTERNAL_IPV6_SUBNETWORK_CREATION or INTERNAL_IPV6_SUBNETWORK_CREATION
mode. Use one of the following formats to specify a sub-PDP when creating
a dual stack or IPv6-only subnetwork using BYOIP:
Full resource URL, as in:
final
-
ipv6AccessType
→ Input<
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 ipv6Type is EXTERNAL then this subnet
cannot enable direct path.
Possible values are:
EXTERNAL,INTERNAL.final -
logConfig
→ Input<
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
purposefield is set to subnetwork isREGIONAL_MANAGED_PROXYorGLOBAL_MANAGED_PROXY. Structure is documented below.final -
name
→ Input<
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.final -
network
→ Input<
String> -
The network this subnet belongs to.
Only networks that are in the distributed mode can have subnetworks.
final
-
params
→ Input<
SubnetworkParams?> ? -
Additional params passed with the request, but not persisted as part of resource payload
Structure is documented below.
final
-
privateIpGoogleAccess
→ Input<
bool?> ? -
When enabled, VMs in this subnetwork without external IP addresses can
access Google APIs and services by using Private Google Access.
final
-
privateIpv6GoogleAccess
→ Input<
String?> ? -
The private IPv6 google access type for the VMs in this subnet.
final
-
project
→ Input<
String?> ? -
The ID of the project in which the resource belongs.
If it is not provided, the provider project is used.
final
-
purpose
→ Input<
String?> ? -
The purpose of the resource. This field can be either
PRIVATE,REGIONAL_MANAGED_PROXY,GLOBAL_MANAGED_PROXY,PRIVATE_SERVICE_CONNECT,PEER_MIGRATIONorPRIVATE_NAT(Beta). A subnet with purpose set toREGIONAL_MANAGED_PROXYis a user-created subnetwork that is reserved for regional Envoy-based load balancers. A subnetwork in a given region with purpose set toGLOBAL_MANAGED_PROXYis a proxy-only subnet and is shared between all the cross-regional Envoy-based load balancers. A subnetwork with purpose set toPRIVATE_SERVICE_CONNECTreserves the subnet for hosting a Private Service Connect published service. A subnetwork with purpose set toPEER_MIGRATIONis a user created subnetwork that is reserved for migrating resources from one peered network to another. A subnetwork with purpose set toPRIVATE_NATis used as source range for Private NAT gateways. Note thatREGIONAL_MANAGED_PROXYis the preferred setting for all regional Envoy load balancers. If unspecified, the purpose defaults toPRIVATE.final -
region
→ Input<
String?> ? -
The GCP region for this subnetwork.
final
-
reservedInternalRange
→ Input<
String?> ? -
The ID of the reserved internal range. Must be prefixed with
networkconnectivity.googleapis.comE.g.networkconnectivity.googleapis.com/projects/{project}/locations/global/internalRanges/{rangeId}final -
resolveSubnetMask
→ Input<
String?> ? -
'Configures subnet mask resolution for this subnetwork.'
Possible values are:
ARP_ALL_RANGES,ARP_PRIMARY_RANGE,ARP_BROADCAST_PRIMARY_RANGE,ARP_BROADCAST_PRIMARY_RANGE_WITH_LEARNING.final -
role
→ Input<
String?> ? -
The role of subnetwork.
Currently, this field is only used when
purposeisREGIONAL_MANAGED_PROXY. The value can be set toACTIVEorBACKUP. AnACTIVEsubnetwork is one that is currently being used for Envoy-based load balancers in a region. ABACKUPsubnetwork is one that is ready to be promoted toACTIVEor is currently draining. Possible values are:ACTIVE,BACKUP.final - runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
-
secondaryIpRanges
→ Input<
List< ?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.
final
-
sendSecondaryIpRangeIfEmpty
→ Input<
bool?> ? -
Controls the removal behavior of secondary_ip_range.
When false, removing secondaryIpRange from config will not produce a diff as
the provider will default to the API's value.
When true, the provider will treat removing secondaryIpRange as sending an
empty list of secondary IP ranges to the API.
Defaults to false.
final
-
stackType
→ Input<
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,IPV6_ONLY.final
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toMap(
) → Map< String, dynamic> -
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited