Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • Машинное обучение
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Истории успеха
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Application Load Balancer
  • Начало работы
  • Управление доступом
  • Правила тарификации
  • Справочник Terraform
    • Аутентификация в API
      • Overview
        • Overview
        • Get
        • List
        • Create
        • Update
        • Delete
        • AddTargets
        • RemoveTargets
        • ListOperations
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Логи L7-балансировщика
  • История изменений
  • Обучающие курсы

В этой статье:

  • gRPC request
  • ListTargetGroupsRequest
  • ListTargetGroupsResponse
  • TargetGroup
  • Target
  1. Справочник API
  2. gRPC (англ.)
  3. TargetGroup
  4. List

Application Load Balancer API, gRPC: TargetGroupService.List

Статья создана
Yandex Cloud
Обновлена 17 декабря 2024 г.
  • gRPC request
  • ListTargetGroupsRequest
  • ListTargetGroupsResponse
  • TargetGroup
  • Target

Lists target groups in the specified folder.

gRPC requestgRPC request

rpc List (ListTargetGroupsRequest) returns (ListTargetGroupsResponse)

ListTargetGroupsRequestListTargetGroupsRequest

{
  "folder_id": "string",
  "page_size": "int64",
  "page_token": "string",
  "filter": "string"
}

Field

Description

folder_id

string

Required field. ID of the folder to list target groups in.

To get the folder ID, make a yandex.cloud.resourcemanager.v1.FolderService.List request.

page_size

int64

The maximum number of results per page to return. If the number of available
results is larger than page_size, the service returns a ListTargetGroupsResponse.next_page_token
that can be used to get the next page of results in subsequent list requests.
Default value: 100.

page_token

string

Page token. To get the next page of results, set page_token to the
ListTargetGroupsResponse.next_page_token returned by a previous list request.

filter

string

A filter expression that filters target groups listed in the response.

The expression must specify:

  1. The field name. Currently you can use filtering only on TargetGroup.name field.
  2. An = operator.
  3. The value in double quotes ("). Must be 3-63 characters long and match the regular expression [a-z][-a-z0-9]{1,61}[a-z0-9].
    Example of a filter: name=my-target-group.

ListTargetGroupsResponseListTargetGroupsResponse

{
  "target_groups": [
    {
      "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"
    }
  ],
  "next_page_token": "string"
}

Field

Description

target_groups[]

TargetGroup

List of target groups in the specified folder.

next_page_token

string

Token for getting the next page of the list. If the number of results is greater than
the specified ListTargetGroupsRequest.page_size, use next_page_token as the value
for the ListTargetGroupsRequest.page_token parameter in the next list request.

Each subsequent page will have its own next_page_token to continue paging through the results.

TargetGroupTargetGroup

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.

TargetTarget

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.

Была ли статья полезна?

Предыдущая
Get
Следующая
Create
Проект Яндекса
© 2025 ООО «Яндекс.Облако»