Discuss with expertTry it for free
© 2026 Direct Cursus Technology L.L.C.

Network Load Balancer API, REST: NetworkLoadBalancer.GetTargetStates

Written by
Updated at July 1, 2026
View in Markdown

Gets states of target resources in the attached target group.

HTTP request

GET https://load-balancer.api.cloud.yandex.net/load-balancer/v1/networkLoadBalancers/{networkLoadBalancerId}:getTargetStates

Path parameters

Field

Description

networkLoadBalancerId

string

Required field. ID of the NetworkLoadBalancer resource with an attached target group.
The length must be less than or equal to 50.

Query parameters

Field

Description

targetGroupId

string

ID of the target group to get states of resources from.
The length must be less than or equal to 50.

Response

HTTP Code: 200 - OK

{
  "targetStates": [
    {
      "subnetId": "string",
      "address": "string",
      "status": "string",
      "zoneShifted": "boolean"
    }
  ]
}

Field

Description

targetStates[]

TargetState

List of states of targets within the target group that is specified in the GetTargetStatesRequest message.

TargetState

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

Field

Description

subnetId

string

ID of the subnet that the target is connected to.

address

string

IP address of the target.

status

enum (Status)

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.

zoneShifted

boolean

Zone shifted status.
Previous
DetachTargetGroup
Next
AddListener