Application Load Balancer API, gRPC: LoadBalancerService.GetTargetStates

Field

Description

loadBalancerId

string

Required field. ID of the application load balancer that the backend group is attributed to.

backendGroupId

string

Required field. ID of the backend group that the target group is attributed to.

targetGroupId

string

Required field. ID of the target group to get target states of.

Field

Description

targetStates[]

TargetState

Target states of the specified target group.

Field

Description

status

HealthcheckStatus

Health of the target, i.e. its statuses in all availability zones.

target

Target

Required field. Target.

Field

Description

zoneStatuses[]

ZoneHealthcheckStatus

Statuses of the target in its availability zones.

Field

Description

zoneId

string

Required field. ID of the availability zone.

status

enum Status

Status of the target in the availability zone.

• STATUS_UNSPECIFIED
• HEALTHY: All of the health checks specified in HttpBackend.healthchecks or GrpcBackend.healthchecks are passed
  (the number depends on the HealthCheck.healthyThreshold setting) and the target is ready to receive traffic.
• PARTIALLY_HEALTHY: Some of the health checks specified in HttpBackend.healthchecks or GrpcBackend.healthchecks failed
  (the number depends on the HealthCheck.unhealthyThreshold setting).
  The target is ready to receive traffic from the load balancer nodes which, based on their health checks,
  consider the target healthy.
• UNHEALTHY: All of the health checks specified in HttpBackend.healthchecks or GrpcBackend.healthchecks failed
  (the number depends on the HealthCheck.unhealthyThreshold setting) and the target is not receiving traffic.
• DRAINING: Target is being deleted and the application load balancer is no longer sending traffic to this target.
• TIMEOUT

failedActiveHc

bool

Indicates whether the target has been marked UNHEALTHY due to failing active health checks,
which determine target statuses as configured in HttpBackend.healthchecks or GrpcBackend.healthchecks.

Currently the only type of health checks is active, as described above.
Passive health checks, which determine the health of a target based on its responses to production requests
(HTTP 5xx status codes, connection errors etc.), are not implemented yet.

Field

Description

ipAddress

string

IP address of the target.

Includes only one of the fields ipAddress.

Reference to the target. As of now, targets must only be referred to by their IP addresses.

subnetId

string

ID of the subnet that the target is connected to.

privateIpv4Address

bool

If set, will not require subnet_id to validate the target.
Instead, the address should belong to one of the following ranges:
10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16
Only one of subnet_id or private_ipv4_address should be set.