Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
    • Yandex Cloud Partner program
  • Blog
  • Pricing
  • Documentation
© 2025 Direct Cursus Technology L.L.C.
Yandex Network Load Balancer
  • Getting started
  • Access management
  • Pricing policy
  • Terraform reference
    • Authentication with the API
      • Overview
        • Overview
        • Get
        • List
        • Create
        • Update
        • Delete
        • Start
        • Stop
        • AttachTargetGroup
        • DetachTargetGroup
        • GetTargetStates
        • AddListener
        • RemoveListener
        • ListOperations
  • Monitoring metrics
  • Audit Trails events
  • Release notes
  • FAQ

In this article:

  • gRPC request
  • GetTargetStatesRequest
  • GetTargetStatesResponse
  • TargetState
  1. API reference
  2. gRPC
  3. NetworkLoadBalancer
  4. GetTargetStates

Network Load Balancer API, gRPC: NetworkLoadBalancerService.GetTargetStates

Written by
Yandex Cloud
Updated at November 26, 2024
  • gRPC request
  • GetTargetStatesRequest
  • GetTargetStatesResponse
  • TargetState

Gets states of target resources in the attached target group.

gRPC request

rpc GetTargetStates (GetTargetStatesRequest) returns (GetTargetStatesResponse)

GetTargetStatesRequest

{
  "network_load_balancer_id": "string",
  "target_group_id": "string"
}

Field

Description

network_load_balancer_id

string

ID of the NetworkLoadBalancer resource with an attached target group.

target_group_id

string

ID of the target group to get states of resources from.

GetTargetStatesResponse

{
  "target_states": [
    {
      "subnet_id": "string",
      "address": "string",
      "status": "Status"
    }
  ]
}

Field

Description

target_states[]

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

subnet_id

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.

  • STATUS_UNSPECIFIED
  • 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.

Was the article helpful?

Previous
DetachTargetGroup
Next
AddListener
© 2025 Direct Cursus Technology L.L.C.