Yandex Cloud
  • Сервисы
  • Решения
  • Почему Yandex Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Language / Region
Проект Яндекса
© 2023 ООО «Яндекс.Облако»
Yandex Network Load Balancer
  • Начало работы
  • Пошаговые инструкции
    • Все инструкции
    • Сетевые балансировщики
      • Создать балансировщик
      • Создать внутренний балансировщик
      • Запустить балансировщик
      • Остановить балансировщик
      • Удалить балансировщик
      • Проверить состояние целевых ресурсов
      • Добавить обработчик
      • Удалить обработчик
    • Целевые группы
      • Создать целевую группу
      • Подключить целевую группу к балансировщику
      • Отключить целевую группу от балансировщика
      • Удалить целевую группу
  • Концепции
    • Сетевой балансировщик нагрузки
    • Внутренний сетевой балансировщик
    • Обработчик
    • Целевые ресурсы и группы
    • Проверка состояния ресурсов
    • Квоты и лимиты
  • Рекомендации по использованию сервиса
  • Управление доступом
  • Правила тарификации
  • Справочник API
    • Аутентификация в API
    • gRPC (англ.)
      • Overview
      • NetworkLoadBalancerService
      • TargetGroupService
      • OperationService
    • REST (англ.)
      • Overview
      • NetworkLoadBalancer
        • Overview
        • addListener
        • attachTargetGroup
        • create
        • delete
        • detachTargetGroup
        • get
        • getTargetStates
        • list
        • listOperations
        • removeListener
        • start
        • stop
        • update
      • TargetGroup
        • Overview
        • addTargets
        • create
        • delete
        • get
        • list
        • listOperations
        • removeTargets
        • update
      • Operation
        • Overview
        • get
  • Вопросы и ответы
  1. Справочник API
  2. REST (англ.)
  3. NetworkLoadBalancer
  4. list

Network Load Balancer API, REST: NetworkLoadBalancer.list

Статья создана
Yandex Cloud
  • HTTP request
  • Query parameters
  • Response

Retrieves the list of NetworkLoadBalancer resources in the specified folder.

HTTP request

GET https://load-balancer.api.cloud.yandex.net/load-balancer/v1/networkLoadBalancers

Query parameters

Parameter Description
folderId

Required. ID of the folder that the network load balancer belongs to. To get the folder ID, use a list request.

The maximum string length in characters is 50.

pageSize

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

The maximum value is 1000.

pageToken

Page token. To get the next page of results, set pageToken to the nextPageToken returned by a previous list request.

The maximum string length in characters is 100.

filter

A filter expression that filters resources listed in the response. The expression must specify:

  1. The field name. Currently you can only filter by the NetworkLoadBalancer.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].

The maximum string length in characters is 1000.

Response

HTTP Code: 200 - OK

{
  "networkLoadBalancers": [
    {
      "id": "string",
      "folderId": "string",
      "createdAt": "string",
      "name": "string",
      "description": "string",
      "labels": "object",
      "regionId": "string",
      "status": "string",
      "type": "string",
      "sessionAffinity": "string",
      "listeners": [
        {
          "name": "string",
          "address": "string",
          "port": "string",
          "protocol": "string",
          "targetPort": "string",
          "subnetId": "string",
          "ipVersion": "string"
        }
      ],
      "attachedTargetGroups": [
        {
          "targetGroupId": "string",
          "healthChecks": [
            {
              "name": "string",
              "interval": "string",
              "timeout": "string",
              "unhealthyThreshold": "string",
              "healthyThreshold": "string",

              // `networkLoadBalancers[].attachedTargetGroups[].healthChecks[]` includes only one of the fields `tcpOptions`, `httpOptions`
              "tcpOptions": {
                "port": "string"
              },
              "httpOptions": {
                "port": "string",
                "path": "string"
              },
              // end of the list of possible fields`networkLoadBalancers[].attachedTargetGroups[].healthChecks[]`

            }
          ]
        }
      ],
      "deletionProtection": true
    }
  ],
  "nextPageToken": "string"
}
Field Description
networkLoadBalancers[] object

List of NetworkLoadBalancer resources.

networkLoadBalancers[].
id
string

ID of the network load balancer.

networkLoadBalancers[].
folderId
string

ID of the folder that the network load balancer belongs to.

networkLoadBalancers[].
createdAt
string (date-time)

Creation timestamp in RFC3339 text format.

String in RFC3339 text format. The range of possible values is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the Protocol Buffers reference. In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

networkLoadBalancers[].
name
string

Name of the network load balancer. The name is unique within the folder. 3-63 characters long.

networkLoadBalancers[].
description
string

Optional description of the network load balancer. 0-256 characters long.

networkLoadBalancers[].
labels
object

Resource labels as key:value pairs. Maximum of 64 per resource.

networkLoadBalancers[].
regionId
string

ID of the region that the network load balancer belongs to.

networkLoadBalancers[].
status
string

Status of the network load balancer.

  • CREATING: Network load balancer is being created.
  • STARTING: Network load balancer is being started.
  • ACTIVE: Network load balancer is active and sends traffic to the targets.
  • STOPPING: Network load balancer is being stopped.
  • STOPPED: Network load balancer is stopped and doesn't send traffic to the targets.
  • DELETING: Network load balancer is being deleted.
  • INACTIVE: The load balancer doesn't have any listeners or target groups, or attached target groups are empty. The load balancer doesn't perform any health checks or send traffic in this state.
networkLoadBalancers[].
type
string

Type of the network load balancer. Only external network load balancers are available now.

Type of the load balancer. Only external load balancers are currently available.

  • EXTERNAL: External network load balancer.
  • INTERNAL: Internal network load balancer.
networkLoadBalancers[].
sessionAffinity
string

Type of the session affinity. Only 5-tuple affinity is available now.

Type of session affinity. Only 5-tuple affinity is currently available. For more information, see Load Balancer concepts.

  • CLIENT_IP_PORT_PROTO: 5-tuple affinity.
networkLoadBalancers[].
listeners[]
object

List of listeners for the network load balancer.

networkLoadBalancers[].
listeners[].
name
string

Name of the listener. The name must be unique for each listener on a single load balancer. 3-63 characters long.

networkLoadBalancers[].
listeners[].
address
string

IP address for the listener.

networkLoadBalancers[].
listeners[].
port
string (int64)

Port.

networkLoadBalancers[].
listeners[].
protocol
string

Network protocol for incoming traffic.

Network protocol to use.

networkLoadBalancers[].
listeners[].
targetPort
string (int64)

Port of a target.

networkLoadBalancers[].
listeners[].
subnetId
string

ID of the subnet.

networkLoadBalancers[].
listeners[].
ipVersion
string

IP version of the external address.

IP version of the addresses that the load balancer works with. Only IPv4 is currently available.

  • IPV4: IPv4
  • IPV6: IPv6
networkLoadBalancers[].
attachedTargetGroups[]
object

List of target groups attached to the network load balancer.

networkLoadBalancers[].
attachedTargetGroups[].
targetGroupId
string

Required. ID of the target group.

The maximum string length in characters is 50.

networkLoadBalancers[].
attachedTargetGroups[].
healthChecks[]
object

Required. A health check to perform on the target group. For now we accept only one health check per AttachedTargetGroup.

Must contain exactly 1 element.

networkLoadBalancers[].
attachedTargetGroups[].
healthChecks[].
name
string

Required. Name of the health check. The name must be unique for each target group that attached to a single load balancer. 3-63 characters long.

Value must match the regular expression |[a-z][-a-z0-9]{1,61}[a-z0-9].

networkLoadBalancers[].
attachedTargetGroups[].
healthChecks[].
interval
string

The interval between health checks. The default is 2 seconds.

networkLoadBalancers[].
attachedTargetGroups[].
healthChecks[].
timeout
string

Timeout for a target to return a response for the health check. The default is 1 second.

networkLoadBalancers[].
attachedTargetGroups[].
healthChecks[].
unhealthyThreshold
string (int64)

Number of failed health checks before changing the status to UNHEALTHY. The default is 2.

Acceptable values are 2 to 10, inclusive.

networkLoadBalancers[].
attachedTargetGroups[].
healthChecks[].
healthyThreshold
string (int64)

Number of successful health checks required in order to set the HEALTHY status for the target. The default is 2.

Acceptable values are 2 to 10, inclusive.

networkLoadBalancers[].
attachedTargetGroups[].
healthChecks[].
tcpOptions
object
Options for TCP health check.
networkLoadBalancers[].attachedTargetGroups[].healthChecks[] includes only one of the fields tcpOptions, httpOptions
networkLoadBalancers[].
attachedTargetGroups[].
healthChecks[].
tcpOptions.
port
string (int64)

Port to use for TCP health checks.

Acceptable values are 1 to 65535, inclusive.

networkLoadBalancers[].
attachedTargetGroups[].
healthChecks[].
httpOptions
object
Options for HTTP health check.
networkLoadBalancers[].attachedTargetGroups[].healthChecks[] includes only one of the fields tcpOptions, httpOptions
networkLoadBalancers[].
attachedTargetGroups[].
healthChecks[].
httpOptions.
port
string (int64)

Port to use for HTTP health checks.

Acceptable values are 1 to 65535, inclusive.

networkLoadBalancers[].
attachedTargetGroups[].
healthChecks[].
httpOptions.
path
string

URL path to set for health checking requests for every target in the target group. For example /ping. The default path is /.

networkLoadBalancers[].
deletionProtection
boolean (boolean)

Specifies if network load balancer protected from deletion.

nextPageToken string

This token allows you to get the next page of results for list requests. If the number of results is larger than pageSize, use the nextPageToken as the value for the pageToken query parameter in the next list request. Each subsequent list request will have its own nextPageToken to continue paging through the results.

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

Language / Region
Проект Яндекса
© 2023 ООО «Яндекс.Облако»
В этой статье:
  • HTTP request
  • Query parameters
  • Response