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 Application Load Balancer
  • Getting started
  • Access management
  • Pricing policy
  • Terraform reference
    • Authentication with the API
      • Overview
        • Overview
        • Get
        • List
        • Create
        • Update
        • Delete
        • AddTargets
        • RemoveTargets
        • ListOperations
  • Monitoring metrics
  • Audit Trails events
  • L7 load balancer logs
  • Release notes

In this article:

  • gRPC request
  • GetTargetGroupRequest
  • TargetGroup
  • Target
  1. API reference
  2. gRPC
  3. TargetGroup
  4. Get

Application Load Balancer API, gRPC: TargetGroupService.Get

Written by
Yandex Cloud
Updated at December 17, 2024
  • gRPC request
  • GetTargetGroupRequest
  • TargetGroup
  • Target

Returns the specified target group.

To get the list of all available target groups, make a List request.

gRPC request

rpc Get (GetTargetGroupRequest) returns (TargetGroup)

GetTargetGroupRequest

{
  "target_group_id": "string"
}

Field

Description

target_group_id

string

Required field. ID of the target group to return.

To get the target group ID, make a TargetGroupService.List request.

TargetGroup

{
  "id": "string",
  "name": "string",
  "description": "string",
  "folder_id": "string",
  "labels": "map<string, string>",
  "targets": [
    {
      // Includes only one of the fields `ip_address`
      "ip_address": "string",
      // end of the list of possible fields
      "subnet_id": "string",
      "private_ipv4_address": "bool"
    }
  ],
  "created_at": "google.protobuf.Timestamp"
}

A target group resource.
For details about the concept, see documentation.

Field

Description

id

string

ID of the target group. Generated at creation time.

name

string

Name of the target group. The name is unique within the folder.

description

string

Description of the target group.

folder_id

string

ID of the folder that the target group belongs to.

labels

object (map<string, string>)

Target group labels as key:value pairs.
For details about the concept, see documentation.

targets[]

Target

List of targets in the target group.

created_at

google.protobuf.Timestamp

Creation timestamp.

Target

A target resource.
For details about the concept, see documentation.

Field

Description

ip_address

string

IP address of the target.

Includes only one of the fields ip_address.

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

subnet_id

string

ID of the subnet that the target is connected to.

private_ipv4_address

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.

Was the article helpful?

Previous
Overview
Next
List
© 2025 Direct Cursus Technology L.L.C.