pub struct ForwardingRuleArgsBuilder<S: State = Empty> { /* private fields */ }
Expand description
Use builder syntax to set the inputs and finish with build_struct()
.
Implementations§
source§impl<S: State> ForwardingRuleArgsBuilder<S>
impl<S: State> ForwardingRuleArgsBuilder<S>
sourcepub fn build_struct(self) -> ForwardingRuleArgswhere
S: IsComplete,
pub fn build_struct(self) -> ForwardingRuleArgswhere
S: IsComplete,
Finish building and return the requested object
sourcepub fn all_ports(
self,
value: impl Into<Output<Option<bool>>>,
) -> ForwardingRuleArgsBuilder<SetAllPorts<S>>where
S::AllPorts: IsUnset,
pub fn all_ports(
self,
value: impl Into<Output<Option<bool>>>,
) -> ForwardingRuleArgsBuilder<SetAllPorts<S>>where
S::AllPorts: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<bool>> as Default>::default()
.
The ports
, portRange
, and allPorts
fields are mutually exclusive.
Only packets addressed to ports in the specified range will be forwarded
to the backends configured with this forwarding rule.
The allPorts
field has the following limitations:
- It requires that the forwarding rule
IPProtocol
be TCP, UDP, SCTP, or L3_DEFAULT. - It’s applicable only to the following products: internal passthrough Network Load Balancers, backend service-based external passthrough Network Load Balancers, and internal and external protocol forwarding.
- Set this field to true to allow packets addressed to any port or packets
lacking destination port information (for example, UDP fragments after the
first fragment) to be forwarded to the backends configured with this
forwarding rule. The L3_DEFAULT protocol requires
allPorts
be set to true.
sourcepub fn maybe_all_ports(
self,
value: Option<impl Into<Output<Option<bool>>>>,
) -> ForwardingRuleArgsBuilder<SetAllPorts<S>>where
S::AllPorts: IsUnset,
pub fn maybe_all_ports(
self,
value: Option<impl Into<Output<Option<bool>>>>,
) -> ForwardingRuleArgsBuilder<SetAllPorts<S>>where
S::AllPorts: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<bool>> as Default>::default()
.
The ports
, portRange
, and allPorts
fields are mutually exclusive.
Only packets addressed to ports in the specified range will be forwarded
to the backends configured with this forwarding rule.
The allPorts
field has the following limitations:
- It requires that the forwarding rule
IPProtocol
be TCP, UDP, SCTP, or L3_DEFAULT. - It’s applicable only to the following products: internal passthrough Network Load Balancers, backend service-based external passthrough Network Load Balancers, and internal and external protocol forwarding.
- Set this field to true to allow packets addressed to any port or packets
lacking destination port information (for example, UDP fragments after the
first fragment) to be forwarded to the backends configured with this
forwarding rule. The L3_DEFAULT protocol requires
allPorts
be set to true.
sourcepub fn allow_global_access(
self,
value: impl Into<Output<Option<bool>>>,
) -> ForwardingRuleArgsBuilder<SetAllowGlobalAccess<S>>where
S::AllowGlobalAccess: IsUnset,
pub fn allow_global_access(
self,
value: impl Into<Output<Option<bool>>>,
) -> ForwardingRuleArgsBuilder<SetAllowGlobalAccess<S>>where
S::AllowGlobalAccess: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<bool>> as Default>::default()
.
This field is used along with the backend_service
field for
internal load balancing or with the target
field for internal
TargetInstance.
If the field is set to TRUE
, clients can access ILB from all
regions.
Otherwise only allows access from clients in the same region as the
internal load balancer.
sourcepub fn maybe_allow_global_access(
self,
value: Option<impl Into<Output<Option<bool>>>>,
) -> ForwardingRuleArgsBuilder<SetAllowGlobalAccess<S>>where
S::AllowGlobalAccess: IsUnset,
pub fn maybe_allow_global_access(
self,
value: Option<impl Into<Output<Option<bool>>>>,
) -> ForwardingRuleArgsBuilder<SetAllowGlobalAccess<S>>where
S::AllowGlobalAccess: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<bool>> as Default>::default()
.
This field is used along with the backend_service
field for
internal load balancing or with the target
field for internal
TargetInstance.
If the field is set to TRUE
, clients can access ILB from all
regions.
Otherwise only allows access from clients in the same region as the
internal load balancer.
sourcepub fn allow_psc_global_access(
self,
value: impl Into<Output<Option<bool>>>,
) -> ForwardingRuleArgsBuilder<SetAllowPscGlobalAccess<S>>where
S::AllowPscGlobalAccess: IsUnset,
pub fn allow_psc_global_access(
self,
value: impl Into<Output<Option<bool>>>,
) -> ForwardingRuleArgsBuilder<SetAllowPscGlobalAccess<S>>where
S::AllowPscGlobalAccess: IsUnset,
sourcepub fn maybe_allow_psc_global_access(
self,
value: Option<impl Into<Output<Option<bool>>>>,
) -> ForwardingRuleArgsBuilder<SetAllowPscGlobalAccess<S>>where
S::AllowPscGlobalAccess: IsUnset,
pub fn maybe_allow_psc_global_access(
self,
value: Option<impl Into<Output<Option<bool>>>>,
) -> ForwardingRuleArgsBuilder<SetAllowPscGlobalAccess<S>>where
S::AllowPscGlobalAccess: IsUnset,
sourcepub fn backend_service(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetBackendService<S>>where
S::BackendService: IsUnset,
pub fn backend_service(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetBackendService<S>>where
S::BackendService: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
Identifies the backend service to which the forwarding rule sends traffic. Required for Internal TCP/UDP Load Balancing and Network Load Balancing; must be omitted for all other load balancer types.
sourcepub fn maybe_backend_service(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetBackendService<S>>where
S::BackendService: IsUnset,
pub fn maybe_backend_service(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetBackendService<S>>where
S::BackendService: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
Identifies the backend service to which the forwarding rule sends traffic. Required for Internal TCP/UDP Load Balancing and Network Load Balancing; must be omitted for all other load balancer types.
sourcepub fn description(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetDescription<S>>where
S::Description: IsUnset,
pub fn description(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetDescription<S>>where
S::Description: IsUnset,
sourcepub fn maybe_description(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetDescription<S>>where
S::Description: IsUnset,
pub fn maybe_description(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetDescription<S>>where
S::Description: IsUnset,
sourcepub fn ip_address(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetIpAddress<S>>where
S::IpAddress: IsUnset,
pub fn ip_address(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetIpAddress<S>>where
S::IpAddress: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
IP address for which this forwarding rule accepts traffic. When a client
sends traffic to this IP address, the forwarding rule directs the traffic
to the referenced target
or backendService
.
While creating a forwarding rule, specifying an IPAddress
is
required under the following circumstances:
- When the
target
is set totargetGrpcProxy
andvalidateForProxyless
is set totrue
, theIPAddress
should be set to0.0.0.0
. - When the
target
is a Private Service Connect Google APIs bundle, you must specify anIPAddress
. Otherwise, you can optionally specify an IP address that references an existing static (reserved) IP address resource. When omitted, Google Cloud assigns an ephemeral IP address. Use one of the following formats to specify an IP address while creating a forwarding rule: - IP address number, as in
100.1.2.3
- IPv6 address range, as in
2600:1234::/96
- Full resource URL, as in
https://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name
- Partial URL or by name, as in:
projects/project_id/regions/region/addresses/address-name
regions/region/addresses/address-name
global/addresses/address-name
address-name
The forwarding rule’starget
orbackendService
, and in most cases, also theloadBalancingScheme
, determine the type of IP address that you can use. For detailed information, see IP address specifications. When reading anIPAddress
, the API always returns the IP address number.
sourcepub fn maybe_ip_address(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetIpAddress<S>>where
S::IpAddress: IsUnset,
pub fn maybe_ip_address(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetIpAddress<S>>where
S::IpAddress: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
IP address for which this forwarding rule accepts traffic. When a client
sends traffic to this IP address, the forwarding rule directs the traffic
to the referenced target
or backendService
.
While creating a forwarding rule, specifying an IPAddress
is
required under the following circumstances:
- When the
target
is set totargetGrpcProxy
andvalidateForProxyless
is set totrue
, theIPAddress
should be set to0.0.0.0
. - When the
target
is a Private Service Connect Google APIs bundle, you must specify anIPAddress
. Otherwise, you can optionally specify an IP address that references an existing static (reserved) IP address resource. When omitted, Google Cloud assigns an ephemeral IP address. Use one of the following formats to specify an IP address while creating a forwarding rule: - IP address number, as in
100.1.2.3
- IPv6 address range, as in
2600:1234::/96
- Full resource URL, as in
https://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name
- Partial URL or by name, as in:
projects/project_id/regions/region/addresses/address-name
regions/region/addresses/address-name
global/addresses/address-name
address-name
The forwarding rule’starget
orbackendService
, and in most cases, also theloadBalancingScheme
, determine the type of IP address that you can use. For detailed information, see IP address specifications. When reading anIPAddress
, the API always returns the IP address number.
sourcepub fn ip_protocol(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetIpProtocol<S>>where
S::IpProtocol: IsUnset,
pub fn ip_protocol(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetIpProtocol<S>>where
S::IpProtocol: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
The IP protocol to which this rule applies.
For protocol forwarding, valid
options are TCP
, UDP
, ESP
,
AH
, SCTP
, ICMP
and
L3_DEFAULT
.
The valid IP protocols are different for different load balancing products
as described in Load balancing
features.
A Forwarding Rule with protocol L3_DEFAULT can attach with target instance or
backend service with UNSPECIFIED protocol.
A forwarding rule with “L3_DEFAULT” IPProtocal cannot be attached to a backend service with TCP or UDP.
Possible values are: TCP
, UDP
, ESP
, AH
, SCTP
, ICMP
, L3_DEFAULT
.
sourcepub fn maybe_ip_protocol(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetIpProtocol<S>>where
S::IpProtocol: IsUnset,
pub fn maybe_ip_protocol(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetIpProtocol<S>>where
S::IpProtocol: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
The IP protocol to which this rule applies.
For protocol forwarding, valid
options are TCP
, UDP
, ESP
,
AH
, SCTP
, ICMP
and
L3_DEFAULT
.
The valid IP protocols are different for different load balancing products
as described in Load balancing
features.
A Forwarding Rule with protocol L3_DEFAULT can attach with target instance or
backend service with UNSPECIFIED protocol.
A forwarding rule with “L3_DEFAULT” IPProtocal cannot be attached to a backend service with TCP or UDP.
Possible values are: TCP
, UDP
, ESP
, AH
, SCTP
, ICMP
, L3_DEFAULT
.
sourcepub fn ip_version(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetIpVersion<S>>where
S::IpVersion: IsUnset,
pub fn ip_version(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetIpVersion<S>>where
S::IpVersion: IsUnset,
sourcepub fn maybe_ip_version(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetIpVersion<S>>where
S::IpVersion: IsUnset,
pub fn maybe_ip_version(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetIpVersion<S>>where
S::IpVersion: IsUnset,
sourcepub fn is_mirroring_collector(
self,
value: impl Into<Output<Option<bool>>>,
) -> ForwardingRuleArgsBuilder<SetIsMirroringCollector<S>>where
S::IsMirroringCollector: IsUnset,
pub fn is_mirroring_collector(
self,
value: impl Into<Output<Option<bool>>>,
) -> ForwardingRuleArgsBuilder<SetIsMirroringCollector<S>>where
S::IsMirroringCollector: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<bool>> as Default>::default()
.
Indicates whether or not this load balancer can be used as a collector for
packet mirroring. To prevent mirroring loops, instances behind this
load balancer will not have their traffic mirrored even if a
PacketMirroring
rule applies to them.
This can only be set to true for load balancers that have their
loadBalancingScheme
set to INTERNAL
.
sourcepub fn maybe_is_mirroring_collector(
self,
value: Option<impl Into<Output<Option<bool>>>>,
) -> ForwardingRuleArgsBuilder<SetIsMirroringCollector<S>>where
S::IsMirroringCollector: IsUnset,
pub fn maybe_is_mirroring_collector(
self,
value: Option<impl Into<Output<Option<bool>>>>,
) -> ForwardingRuleArgsBuilder<SetIsMirroringCollector<S>>where
S::IsMirroringCollector: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<bool>> as Default>::default()
.
Indicates whether or not this load balancer can be used as a collector for
packet mirroring. To prevent mirroring loops, instances behind this
load balancer will not have their traffic mirrored even if a
PacketMirroring
rule applies to them.
This can only be set to true for load balancers that have their
loadBalancingScheme
set to INTERNAL
.
sourcepub fn labels(
self,
value: impl Into<Output<Option<HashMap<String, String>>>>,
) -> ForwardingRuleArgsBuilder<SetLabels<S>>where
S::Labels: IsUnset,
pub fn labels(
self,
value: impl Into<Output<Option<HashMap<String, String>>>>,
) -> ForwardingRuleArgsBuilder<SetLabels<S>>where
S::Labels: IsUnset,
Optional (Some / Option setters). Default:
<pulumi_wasm_rust::Output<
Option<std::collections::HashMap<String, String>>,
> as Default>::default()
Labels to apply to this forwarding rule. A list of key->value pairs.
Note: This field is non-authoritative, and will only manage the labels present in your configuration.
Please refer to the field effective_labels
for all of the labels present on the resource.
sourcepub fn maybe_labels(
self,
value: Option<impl Into<Output<Option<HashMap<String, String>>>>>,
) -> ForwardingRuleArgsBuilder<SetLabels<S>>where
S::Labels: IsUnset,
pub fn maybe_labels(
self,
value: Option<impl Into<Output<Option<HashMap<String, String>>>>>,
) -> ForwardingRuleArgsBuilder<SetLabels<S>>where
S::Labels: IsUnset,
Optional (Some / Option setters). Default:
<pulumi_wasm_rust::Output<
Option<std::collections::HashMap<String, String>>,
> as Default>::default()
Labels to apply to this forwarding rule. A list of key->value pairs.
Note: This field is non-authoritative, and will only manage the labels present in your configuration.
Please refer to the field effective_labels
for all of the labels present on the resource.
sourcepub fn load_balancing_scheme(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetLoadBalancingScheme<S>>where
S::LoadBalancingScheme: IsUnset,
pub fn load_balancing_scheme(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetLoadBalancingScheme<S>>where
S::LoadBalancingScheme: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
Specifies the forwarding rule type.
For more information about forwarding rules, refer to
Forwarding rule concepts.
Default value is EXTERNAL
.
Possible values are: EXTERNAL
, EXTERNAL_MANAGED
, INTERNAL
, INTERNAL_MANAGED
.
sourcepub fn maybe_load_balancing_scheme(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetLoadBalancingScheme<S>>where
S::LoadBalancingScheme: IsUnset,
pub fn maybe_load_balancing_scheme(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetLoadBalancingScheme<S>>where
S::LoadBalancingScheme: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
Specifies the forwarding rule type.
For more information about forwarding rules, refer to
Forwarding rule concepts.
Default value is EXTERNAL
.
Possible values are: EXTERNAL
, EXTERNAL_MANAGED
, INTERNAL
, INTERNAL_MANAGED
.
sourcepub fn name(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetName<S>>where
S::Name: IsUnset,
pub fn name(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetName<S>>where
S::Name: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
Name of the resource; provided by the client when the resource is created.
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.
For Private Service Connect forwarding rules that forward traffic to Google
APIs, the forwarding rule name must be a 1-20 characters string with
lowercase letters and numbers and must start with a letter.
sourcepub fn maybe_name(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetName<S>>where
S::Name: IsUnset,
pub fn maybe_name(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetName<S>>where
S::Name: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
Name of the resource; provided by the client when the resource is created.
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.
For Private Service Connect forwarding rules that forward traffic to Google
APIs, the forwarding rule name must be a 1-20 characters string with
lowercase letters and numbers and must start with a letter.
sourcepub fn network(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetNetwork<S>>where
S::Network: IsUnset,
pub fn network(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetNetwork<S>>where
S::Network: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
This field is not used for external load balancing. For Internal TCP/UDP Load Balancing, this field identifies the network that the load balanced IP should belong to for this Forwarding Rule. If the subnetwork is specified, the network of the subnetwork will be used. If neither subnetwork nor this field is specified, the default network will be used. For Private Service Connect forwarding rules that forward traffic to Google APIs, a network must be provided.
sourcepub fn maybe_network(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetNetwork<S>>where
S::Network: IsUnset,
pub fn maybe_network(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetNetwork<S>>where
S::Network: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
This field is not used for external load balancing. For Internal TCP/UDP Load Balancing, this field identifies the network that the load balanced IP should belong to for this Forwarding Rule. If the subnetwork is specified, the network of the subnetwork will be used. If neither subnetwork nor this field is specified, the default network will be used. For Private Service Connect forwarding rules that forward traffic to Google APIs, a network must be provided.
sourcepub fn network_tier(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetNetworkTier<S>>where
S::NetworkTier: IsUnset,
pub fn network_tier(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetNetworkTier<S>>where
S::NetworkTier: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
This signifies the networking tier used for configuring
this load balancer and can only take the following values:
PREMIUM
, STANDARD
.
For regional ForwardingRule, the valid values are PREMIUM
and
STANDARD
. For GlobalForwardingRule, the valid value is
PREMIUM
.
If this field is not specified, it is assumed to be PREMIUM
.
If IPAddress
is specified, this value must be equal to the
networkTier of the Address.
Possible values are: PREMIUM
, STANDARD
.
sourcepub fn maybe_network_tier(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetNetworkTier<S>>where
S::NetworkTier: IsUnset,
pub fn maybe_network_tier(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetNetworkTier<S>>where
S::NetworkTier: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
This signifies the networking tier used for configuring
this load balancer and can only take the following values:
PREMIUM
, STANDARD
.
For regional ForwardingRule, the valid values are PREMIUM
and
STANDARD
. For GlobalForwardingRule, the valid value is
PREMIUM
.
If this field is not specified, it is assumed to be PREMIUM
.
If IPAddress
is specified, this value must be equal to the
networkTier of the Address.
Possible values are: PREMIUM
, STANDARD
.
sourcepub fn no_automate_dns_zone(
self,
value: impl Into<Output<Option<bool>>>,
) -> ForwardingRuleArgsBuilder<SetNoAutomateDnsZone<S>>where
S::NoAutomateDnsZone: IsUnset,
pub fn no_automate_dns_zone(
self,
value: impl Into<Output<Option<bool>>>,
) -> ForwardingRuleArgsBuilder<SetNoAutomateDnsZone<S>>where
S::NoAutomateDnsZone: IsUnset,
sourcepub fn maybe_no_automate_dns_zone(
self,
value: Option<impl Into<Output<Option<bool>>>>,
) -> ForwardingRuleArgsBuilder<SetNoAutomateDnsZone<S>>where
S::NoAutomateDnsZone: IsUnset,
pub fn maybe_no_automate_dns_zone(
self,
value: Option<impl Into<Output<Option<bool>>>>,
) -> ForwardingRuleArgsBuilder<SetNoAutomateDnsZone<S>>where
S::NoAutomateDnsZone: IsUnset,
sourcepub fn port_range(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetPortRange<S>>where
S::PortRange: IsUnset,
pub fn port_range(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetPortRange<S>>where
S::PortRange: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
The ports
, portRange
, and allPorts
fields are mutually exclusive.
Only packets addressed to ports in the specified range will be forwarded
to the backends configured with this forwarding rule.
The portRange
field has the following limitations:
- It requires that the forwarding rule
IPProtocol
be TCP, UDP, or SCTP, and - It’s applicable only to the following products: external passthrough Network Load Balancers, internal and external proxy Network Load Balancers, internal and external Application Load Balancers, external protocol forwarding, and Classic VPN.
- Some products have restrictions on what ports can be used. See
port specifications
for details.
For external forwarding rules, two or more forwarding rules cannot use the
same
[IPAddress, IPProtocol]
pair, and cannot have overlappingportRange
s. For internal forwarding rules within the same VPC network, two or more forwarding rules cannot use the same[IPAddress, IPProtocol]
pair, and cannot have overlappingportRange
s. @pattern: \d+(?:-\d+)?
sourcepub fn maybe_port_range(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetPortRange<S>>where
S::PortRange: IsUnset,
pub fn maybe_port_range(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetPortRange<S>>where
S::PortRange: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
The ports
, portRange
, and allPorts
fields are mutually exclusive.
Only packets addressed to ports in the specified range will be forwarded
to the backends configured with this forwarding rule.
The portRange
field has the following limitations:
- It requires that the forwarding rule
IPProtocol
be TCP, UDP, or SCTP, and - It’s applicable only to the following products: external passthrough Network Load Balancers, internal and external proxy Network Load Balancers, internal and external Application Load Balancers, external protocol forwarding, and Classic VPN.
- Some products have restrictions on what ports can be used. See
port specifications
for details.
For external forwarding rules, two or more forwarding rules cannot use the
same
[IPAddress, IPProtocol]
pair, and cannot have overlappingportRange
s. For internal forwarding rules within the same VPC network, two or more forwarding rules cannot use the same[IPAddress, IPProtocol]
pair, and cannot have overlappingportRange
s. @pattern: \d+(?:-\d+)?
sourcepub fn ports(
self,
value: impl Into<Output<Option<Vec<String>>>>,
) -> ForwardingRuleArgsBuilder<SetPorts<S>>where
S::Ports: IsUnset,
pub fn ports(
self,
value: impl Into<Output<Option<Vec<String>>>>,
) -> ForwardingRuleArgsBuilder<SetPorts<S>>where
S::Ports: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<Vec<String>>> as Default>::default()
.
The ports
, portRange
, and allPorts
fields are mutually exclusive.
Only packets addressed to ports in the specified range will be forwarded
to the backends configured with this forwarding rule.
The ports
field has the following limitations:
- It requires that the forwarding rule
IPProtocol
be TCP, UDP, or SCTP, and - It’s applicable only to the following products: internal passthrough Network Load Balancers, backend service-based external passthrough Network Load Balancers, and internal protocol forwarding.
- You can specify a list of up to five ports by number, separated by
commas. The ports can be contiguous or discontiguous.
For external forwarding rules, two or more forwarding rules cannot use the
same
[IPAddress, IPProtocol]
pair if they share at least one port number. For internal forwarding rules within the same VPC network, two or more forwarding rules cannot use the same[IPAddress, IPProtocol]
pair if they share at least one port number. @pattern: \d+(?:-\d+)?
sourcepub fn maybe_ports(
self,
value: Option<impl Into<Output<Option<Vec<String>>>>>,
) -> ForwardingRuleArgsBuilder<SetPorts<S>>where
S::Ports: IsUnset,
pub fn maybe_ports(
self,
value: Option<impl Into<Output<Option<Vec<String>>>>>,
) -> ForwardingRuleArgsBuilder<SetPorts<S>>where
S::Ports: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<Vec<String>>> as Default>::default()
.
The ports
, portRange
, and allPorts
fields are mutually exclusive.
Only packets addressed to ports in the specified range will be forwarded
to the backends configured with this forwarding rule.
The ports
field has the following limitations:
- It requires that the forwarding rule
IPProtocol
be TCP, UDP, or SCTP, and - It’s applicable only to the following products: internal passthrough Network Load Balancers, backend service-based external passthrough Network Load Balancers, and internal protocol forwarding.
- You can specify a list of up to five ports by number, separated by
commas. The ports can be contiguous or discontiguous.
For external forwarding rules, two or more forwarding rules cannot use the
same
[IPAddress, IPProtocol]
pair if they share at least one port number. For internal forwarding rules within the same VPC network, two or more forwarding rules cannot use the same[IPAddress, IPProtocol]
pair if they share at least one port number. @pattern: \d+(?:-\d+)?
sourcepub fn project(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetProject<S>>where
S::Project: IsUnset,
pub fn project(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetProject<S>>where
S::Project: IsUnset,
sourcepub fn maybe_project(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetProject<S>>where
S::Project: IsUnset,
pub fn maybe_project(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetProject<S>>where
S::Project: IsUnset,
sourcepub fn recreate_closed_psc(
self,
value: impl Into<Output<Option<bool>>>,
) -> ForwardingRuleArgsBuilder<SetRecreateClosedPsc<S>>where
S::RecreateClosedPsc: IsUnset,
pub fn recreate_closed_psc(
self,
value: impl Into<Output<Option<bool>>>,
) -> ForwardingRuleArgsBuilder<SetRecreateClosedPsc<S>>where
S::RecreateClosedPsc: IsUnset,
sourcepub fn maybe_recreate_closed_psc(
self,
value: Option<impl Into<Output<Option<bool>>>>,
) -> ForwardingRuleArgsBuilder<SetRecreateClosedPsc<S>>where
S::RecreateClosedPsc: IsUnset,
pub fn maybe_recreate_closed_psc(
self,
value: Option<impl Into<Output<Option<bool>>>>,
) -> ForwardingRuleArgsBuilder<SetRecreateClosedPsc<S>>where
S::RecreateClosedPsc: IsUnset,
sourcepub fn region(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetRegion<S>>where
S::Region: IsUnset,
pub fn region(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetRegion<S>>where
S::Region: IsUnset,
sourcepub fn maybe_region(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetRegion<S>>where
S::Region: IsUnset,
pub fn maybe_region(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetRegion<S>>where
S::Region: IsUnset,
sourcepub fn service_directory_registrations(
self,
value: impl Into<Output<Option<ForwardingRuleServiceDirectoryRegistrations>>>,
) -> ForwardingRuleArgsBuilder<SetServiceDirectoryRegistrations<S>>where
S::ServiceDirectoryRegistrations: IsUnset,
pub fn service_directory_registrations(
self,
value: impl Into<Output<Option<ForwardingRuleServiceDirectoryRegistrations>>>,
) -> ForwardingRuleArgsBuilder<SetServiceDirectoryRegistrations<S>>where
S::ServiceDirectoryRegistrations: IsUnset,
Optional (Some / Option setters). Default:
<pulumi_wasm_rust::Output<
Option<super::super::types::compute::ForwardingRuleServiceDirectoryRegistrations>,
> as Default>::default()
Service Directory resources to register this forwarding rule with. Currently, only supports a single Service Directory resource. Structure is documented below.
sourcepub fn maybe_service_directory_registrations(
self,
value: Option<impl Into<Output<Option<ForwardingRuleServiceDirectoryRegistrations>>>>,
) -> ForwardingRuleArgsBuilder<SetServiceDirectoryRegistrations<S>>where
S::ServiceDirectoryRegistrations: IsUnset,
pub fn maybe_service_directory_registrations(
self,
value: Option<impl Into<Output<Option<ForwardingRuleServiceDirectoryRegistrations>>>>,
) -> ForwardingRuleArgsBuilder<SetServiceDirectoryRegistrations<S>>where
S::ServiceDirectoryRegistrations: IsUnset,
Optional (Some / Option setters). Default:
<pulumi_wasm_rust::Output<
Option<super::super::types::compute::ForwardingRuleServiceDirectoryRegistrations>,
> as Default>::default()
Service Directory resources to register this forwarding rule with. Currently, only supports a single Service Directory resource. Structure is documented below.
sourcepub fn service_label(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetServiceLabel<S>>where
S::ServiceLabel: IsUnset,
pub fn service_label(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetServiceLabel<S>>where
S::ServiceLabel: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
An optional prefix to the service name for this Forwarding Rule.
If specified, will be the first label of the fully qualified service
name.
The label must be 1-63 characters long, and comply with RFC1035.
Specifically, the label 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.
This field is only used for INTERNAL load balancing.
sourcepub fn maybe_service_label(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetServiceLabel<S>>where
S::ServiceLabel: IsUnset,
pub fn maybe_service_label(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetServiceLabel<S>>where
S::ServiceLabel: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
An optional prefix to the service name for this Forwarding Rule.
If specified, will be the first label of the fully qualified service
name.
The label must be 1-63 characters long, and comply with RFC1035.
Specifically, the label 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.
This field is only used for INTERNAL load balancing.
sourcepub fn source_ip_ranges(
self,
value: impl Into<Output<Option<Vec<String>>>>,
) -> ForwardingRuleArgsBuilder<SetSourceIpRanges<S>>where
S::SourceIpRanges: IsUnset,
pub fn source_ip_ranges(
self,
value: impl Into<Output<Option<Vec<String>>>>,
) -> ForwardingRuleArgsBuilder<SetSourceIpRanges<S>>where
S::SourceIpRanges: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<Vec<String>>> as Default>::default()
.
If not empty, this Forwarding Rule will only forward the traffic when the source IP address matches one of the IP addresses or CIDR ranges set here. Note that a Forwarding Rule can only have up to 64 source IP ranges, and this field can only be used with a regional Forwarding Rule whose scheme is EXTERNAL. Each sourceIpRange entry should be either an IP address (for example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24).
sourcepub fn maybe_source_ip_ranges(
self,
value: Option<impl Into<Output<Option<Vec<String>>>>>,
) -> ForwardingRuleArgsBuilder<SetSourceIpRanges<S>>where
S::SourceIpRanges: IsUnset,
pub fn maybe_source_ip_ranges(
self,
value: Option<impl Into<Output<Option<Vec<String>>>>>,
) -> ForwardingRuleArgsBuilder<SetSourceIpRanges<S>>where
S::SourceIpRanges: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<Vec<String>>> as Default>::default()
.
If not empty, this Forwarding Rule will only forward the traffic when the source IP address matches one of the IP addresses or CIDR ranges set here. Note that a Forwarding Rule can only have up to 64 source IP ranges, and this field can only be used with a regional Forwarding Rule whose scheme is EXTERNAL. Each sourceIpRange entry should be either an IP address (for example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24).
sourcepub fn subnetwork(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetSubnetwork<S>>where
S::Subnetwork: IsUnset,
pub fn subnetwork(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetSubnetwork<S>>where
S::Subnetwork: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
This field identifies the subnetwork that the load balanced IP should belong to for this Forwarding Rule, used in internal load balancing and network load balancing with IPv6. If the network specified is in auto subnet mode, this field is optional. However, a subnetwork must be specified if the network is in custom subnet mode or when creating external forwarding rule with IPv6.
sourcepub fn maybe_subnetwork(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetSubnetwork<S>>where
S::Subnetwork: IsUnset,
pub fn maybe_subnetwork(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetSubnetwork<S>>where
S::Subnetwork: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
This field identifies the subnetwork that the load balanced IP should belong to for this Forwarding Rule, used in internal load balancing and network load balancing with IPv6. If the network specified is in auto subnet mode, this field is optional. However, a subnetwork must be specified if the network is in custom subnet mode or when creating external forwarding rule with IPv6.
sourcepub fn target(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetTarget<S>>where
S::Target: IsUnset,
pub fn target(
self,
value: impl Into<Output<Option<String>>>,
) -> ForwardingRuleArgsBuilder<SetTarget<S>>where
S::Target: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
The URL of the target resource to receive the matched traffic. For regional forwarding rules, this target must be in the same region as the forwarding rule. For global forwarding rules, this target must be a global load balancing resource. The forwarded traffic must be of a type appropriate to the target object.
- For load balancers, see the “Target” column in Port specifications.
- For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle:
vpc-sc
- APIs that support VPC Service Controls.all-apis
- All supported Google APIs. For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment.
sourcepub fn maybe_target(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetTarget<S>>where
S::Target: IsUnset,
pub fn maybe_target(
self,
value: Option<impl Into<Output<Option<String>>>>,
) -> ForwardingRuleArgsBuilder<SetTarget<S>>where
S::Target: IsUnset,
Optional (Some / Option setters). Default: <pulumi_wasm_rust::Output<Option<String>> as Default>::default()
.
The URL of the target resource to receive the matched traffic. For regional forwarding rules, this target must be in the same region as the forwarding rule. For global forwarding rules, this target must be a global load balancing resource. The forwarded traffic must be of a type appropriate to the target object.
- For load balancers, see the “Target” column in Port specifications.
- For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle:
vpc-sc
- APIs that support VPC Service Controls.all-apis
- All supported Google APIs. For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment.