IPAddresses property

List<String>? IPAddresses
getter/setter pair

IP addresses for which this forwarding rule accepts traffic.

All IP addresses must have the same IP version, IPv4 or IPv6. When a client sends traffic that matches one of the specified IP addresses, protocol and ports, the forwarding rule directs the traffic to the referencedbackendService. All IP addresses are served by the same set of backends, and they share the target capacities specified in the backend service fairly.

Global external Passthrough Network Load Balancer requires two IP addresses for each forwarding rule to provide high availability when both IP addresses are used to serve client requests. The two IP addresses must come from global IP pools that belong to two distinct Availability Groups, represented by the purposePASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP0 andPASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP1. TheIPAddresses field specifies zero, one, or two IP addresses:

  • If omitted, Google Cloud assigns two ephemeral IP addresses, one from each Availability Group.
    • If you specify one IP address that references an existing static IP address resource from one Availability Group, Google Cloud assigns an ephemeral IP address from the other Availability Group.
    • If you specify two IP addresses that reference existing static IP address resources, they are required to be from different Availability Groups.

For global external Passthrough Network Load Balancer, each IP address can be one of the following:

  • A static or ephemeral IPv4 address from a Google-owned IP pool.
  • A static IPv4 address from a global public delegated prefix.
  • A static or ephemeral IPv6 /96 prefix from a Google-owned IP pool.

For global external Passthrough Network Load Balancer, the two IP addresses can be of different types. One IP address can be from a BYOIP prefix while the other is from a Google-owned IP pool. One IP address can be static while the other is ephemeral. However, both IP addresses must have the same IP version, IPv4 or IPv6.

The IP addresses can only be set at creation and cannot be updated.

When creating a global external Passthrough Network Load Balancer forwarding rule (a parent forwarding rule), you must use theIPAddresses field, but the Google Cloud-generated child forwarding rules set the IPAddress field instead. Refer to theavailabilityGroup field for further details.

Refer to the IPAddress field for the formats that can be used to specify IP addresses while creating a forwarding rule.

Because Passthrough Network Load Balancers do not terminate or translate traffic, the backend stack types must be compatible with the forwarding rule IP version:

  • If the forwarding rule IP version is IPv4, backends should be configured as dual-stack or IPv4-only.
  • If the forwarding rule IP version is IPv6, backends should be configured as dual-stack or IPv6-only.

Implementation

core.List<core.String>? IPAddresses;