Skip to main content

types

AttachedTargetGroup​

An AttachedTargetGroup resource. For more information, see Targets and groups.

targetGroupId : string​

ID of the target group.

healthChecks : HealthCheck​

A health check to perform on the target group. For now we accept only one health check per AttachedTargetGroup.

HealthCheck​

A HealthCheck resource. For more information, see Health check.

TcpOptions​

Configuration option for a TCP health check.

port : int64​

Port to use for TCP health checks.

HttpOptions​

Configuration option for an HTTP health check.

port : int64​

Port to use for HTTP health checks.

path : string​

URL path to set for health checking requests for every target in the target group. For example /ping. The default path is /.

name : string​

Name of the health check. The name must be unique for each target group that attached to a single load balancer. 3-63 characters long.

interval : google.protobuf.Duration​

The interval between health checks. The default is 2 seconds.

timeout : google.protobuf.Duration​

Timeout for a target to return a response for the health check. The default is 1 second.

unhealthyThreshold : int64​

Number of failed health checks before changing the status to UNHEALTHY. The default is 2.

healthyThreshold : int64​

Number of successful health checks required in order to set the HEALTHY status for the target. The default is 2.

One of options​

Protocol to use for the health check. Either TCP or HTTP.

  • tcpOptions : TcpOptions​

    Options for TCP health check.

  • httpOptions : HttpOptions​

    Options for HTTP health check.

Listener​

A Listener resource. For more information, see Listener

Protocol​

Network protocol to use.

  • PROTOCOL_UNSPECIFIED

    Network protocol to use.

  • TCP

    Network protocol to use.

  • UDP

    Network protocol to use.

name : string​

Name of the listener. The name must be unique for each listener on a single load balancer. 3-63 characters long.

address : string​

IP address for the listener.

port : int64​

Port.

protocol : Protocol​

Network protocol for incoming traffic.

targetPort : int64​

Port of a target.

subnetId : string​

ID of the subnet.

ipVersion : IpVersion​

IP version of the external address.

NetworkLoadBalancer​

A NetworkLoadBalancer resource. For more information, see Network Load Balancer.

Status​

  • STATUS_UNSPECIFIED

  • CREATING

    Network load balancer is being created.

  • STARTING

    Network load balancer is being started.

  • ACTIVE

    Network load balancer is active and sends traffic to the targets.

  • STOPPING

    Network load balancer is being stopped.

  • STOPPED

    Network load balancer is stopped and doesn't send traffic to the targets.

  • DELETING

    Network load balancer is being deleted.

  • INACTIVE

    The load balancer doesn't have any listeners or target groups, or attached target groups are empty. The load balancer doesn't perform any health checks or send traffic in this state.

Type​

  • TYPE_UNSPECIFIED

  • EXTERNAL

    External network load balancer.

  • INTERNAL

    Internal network load balancer.

SessionAffinity​

Type of session affinity. Only 5-tuple affinity is currently available. For more information, see Load Balancer concepts.

  • SESSION_AFFINITY_UNSPECIFIED

    Type of session affinity. Only 5-tuple affinity is currently available. For more information, see Load Balancer concepts.

  • CLIENT_IP_PORT_PROTO

    5-tuple affinity.

id : string​

ID of the network load balancer.

folderId : string​

ID of the folder that the network load balancer belongs to.

createdAt : google.protobuf.Timestamp​

Creation timestamp in RFC3339 text format.

name : string​

Name of the network load balancer. The name is unique within the folder. 3-63 characters long.

description : string​

Optional description of the network load balancer. 0-256 characters long.

labels : string​

Resource labels as key:value pairs. Maximum of 64 per resource.

regionId : string​

ID of the region that the network load balancer belongs to.

status : Status​

Status of the network load balancer.

type : Type​

Type of the network load balancer. Only external network load balancers are available now.

sessionAffinity : SessionAffinity​

Type of the session affinity. Only 5-tuple affinity is available now.

listeners : Listener​

List of listeners for the network load balancer.

attachedTargetGroups : AttachedTargetGroup​

List of target groups attached to the network load balancer.

deletionProtection : bool​

Specifies if network load balancer protected from deletion.

Target​

A Target resource. For more information, see Target groups and resources.

subnetId : string​

ID of the subnet that targets are connected to. All targets in the target group must be connected to the same subnet within a single availability zone.

address : string​

IP address of the target.

TargetGroup​

A TargetGroup resource. For more information, see Target groups and resources.

id : string​

Output only. ID of the target group.

folderId : string​

ID of the folder that the target group belongs to.

createdAt : google.protobuf.Timestamp​

Output only. Creation timestamp in RFC3339 text format.

name : string​

Name of the target group. The name is unique within the folder. 3-63 characters long.

description : string​

Description of the target group. 0-256 characters long.

labels : string​

Resource labels as key:value pairs. Maximum of 64 per resource.

regionId : string​

ID of the region where the target group resides.

targets : Target​

A list of targets in the target group.

TargetState​

State of the target that was returned after the last health check.

Status​

Status of the target.

  • STATUS_UNSPECIFIED

    Status of the target.

  • INITIAL

    The network load balancer is setting up health checks for this target.

  • HEALTHY

    Health check passed and the target is ready to receive traffic.

  • UNHEALTHY

    Health check failed and the target is not receiving traffic.

  • DRAINING

    Target is being deleted and the network load balancer is no longer sending traffic to this target.

  • INACTIVE

    The network load balancer is stopped and not performing health checks on this target.

subnetId : string​

ID of the subnet that the target is connected to.

address : string​

IP address of the target.

status : Status​

Status of the target.