Yandex Cloud
  • Сервисы
  • Решения
  • Почему Yandex Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Language / Region
© 2022 ООО «Яндекс.Облако»
Yandex Application Load Balancer
  • Начало работы
  • Пошаговые инструкции
    • Все инструкции
    • Целевые группы
      • Создать целевую группу
      • Изменить целевую группу
      • Удалить целевую группу
    • Группы бэкендов
      • Создать группу бэкендов
      • Изменить группу бэкендов
      • Удалить группу бэкендов
    • HTTP-роутеры
      • Создать HTTP-роутер
      • Изменить HTTP-роутер
      • Удалить HTTP-роутер
    • L7-балансировщики
      • Создать L7-балансировщик
      • Изменить L7-балансировщик
      • Посмотреть статистику L7-балансировщика
      • Посмотреть логи L7-балансировщика
      • Получить идентификатор лог-группы L7-балансировщика
      • Остановить и запустить L7-балансировщик
      • Удалить L7-балансировщик
    • Ingress-контроллер для Managed Service for Kubernetes
      • Установить Ingress-контроллер
      • Создать или изменить ресурсы по конфигурации
  • Практические руководства
    • Организация виртуального хостинга
    • Создание балансировщика с защитой от DDoS
    • Интеграция L7-балансировщика с CDN и Object Storage
    • Сине-зеленое и канареечное развертывание версий сервиса
    • Терминирование TLS-соединений
    • Запись логов балансировщика в PostgreSQL
  • Концепции
    • Обзор
    • Балансировщики нагрузки
    • HTTP-роутеры
    • Группы бэкендов
    • Целевые группы
    • Квоты и лимиты
  • Инструменты
    • Ingress Controller для Managed Service for Kubernetes
      • Обзор
      • Принципы работы
      • Группы безопасности
      • Сервисный аккаунт
  • Управление доступом
  • Правила тарификации
  • Справочник API
    • Аутентификация в API
    • gRPC (англ.)
      • Overview
      • BackendGroupService
      • HttpRouterService
      • LoadBalancerService
      • TargetGroupService
      • VirtualHostService
      • OperationService
    • REST (англ.)
      • Overview
      • BackendGroup
        • Overview
        • addBackend
        • create
        • delete
        • get
        • list
        • listOperations
        • removeBackend
        • update
        • updateBackend
      • HttpRouter
        • Overview
        • create
        • delete
        • get
        • list
        • listOperations
        • update
      • LoadBalancer
        • Overview
        • addListener
        • addSniMatch
        • create
        • delete
        • get
        • getTargetStates
        • list
        • listOperations
        • removeListener
        • removeSniMatch
        • start
        • stop
        • update
        • updateListener
        • updateSniMatch
      • TargetGroup
        • Overview
        • addTargets
        • create
        • delete
        • get
        • list
        • listOperations
        • removeTargets
        • update
      • VirtualHost
        • Overview
        • create
        • delete
        • get
        • list
        • removeRoute
        • update
        • updateRoute
  • Справочник Ingress-контроллера
    • Обзор
    • Ingress
    • HttpBackendGroup
    • Service
  • Справочник логов
  1. Справочник API
  2. REST (англ.)
  3. LoadBalancer
  4. get

Method get

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

Returns the specified application load balancer.

To get the list of all available application load balancers, make a list request.

HTTP request

GET https://alb.api.cloud.yandex.net/apploadbalancer/v1/loadBalancers/{loadBalancerId}

Path parameters

Parameter Description
loadBalancerId Required. ID of the application load balancer to return. To get the application load balancer ID, make a list request.

Response

HTTP Code: 200 - OK

{
  "id": "string",
  "name": "string",
  "description": "string",
  "folderId": "string",
  "labels": "object",
  "status": "string",
  "regionId": "string",
  "networkId": "string",
  "listeners": [
    {
      "name": "string",
      "endpoints": [
        {
          "addresses": [
            {

              // `listeners[].endpoints[].addresses[]` includes only one of the fields `externalIpv4Address`, `internalIpv4Address`, `externalIpv6Address`
              "externalIpv4Address": {
                "address": "string"
              },
              "internalIpv4Address": {
                "address": "string",
                "subnetId": "string"
              },
              "externalIpv6Address": {
                "address": "string"
              },
              // end of the list of possible fields`listeners[].endpoints[].addresses[]`

            }
          ],
          "ports": [
            "string"
          ]
        }
      ],

      // `listeners[]` includes only one of the fields `http`, `tls`, `stream`
      "http": {
        "handler": {
          "httpRouterId": "string",

          // `listeners[].http.handler` includes only one of the fields `http2Options`, `allowHttp10`
          "http2Options": {
            "maxConcurrentStreams": "string"
          },
          "allowHttp10": true,
          // end of the list of possible fields`listeners[].http.handler`

        },
        "redirects": {
          "httpToHttps": true
        }
      },
      "tls": {
        "defaultHandler": {
          "certificateIds": [
            "string"
          ],

          // `listeners[].tls.defaultHandler` includes only one of the fields `httpHandler`, `streamHandler`
          "httpHandler": {
            "httpRouterId": "string",

            // `listeners[].tls.defaultHandler.httpHandler` includes only one of the fields `http2Options`, `allowHttp10`
            "http2Options": {
              "maxConcurrentStreams": "string"
            },
            "allowHttp10": true,
            // end of the list of possible fields`listeners[].tls.defaultHandler.httpHandler`

          },
          "streamHandler": {
            "backendGroupId": "string"
          },
          // end of the list of possible fields`listeners[].tls.defaultHandler`

        },
        "sniHandlers": [
          {
            "name": "string",
            "serverNames": [
              "string"
            ],
            "handler": {
              "certificateIds": [
                "string"
              ],

              // `listeners[].tls.sniHandlers[].handler` includes only one of the fields `httpHandler`, `streamHandler`
              "httpHandler": {
                "httpRouterId": "string",

                // `listeners[].tls.sniHandlers[].handler.httpHandler` includes only one of the fields `http2Options`, `allowHttp10`
                "http2Options": {
                  "maxConcurrentStreams": "string"
                },
                "allowHttp10": true,
                // end of the list of possible fields`listeners[].tls.sniHandlers[].handler.httpHandler`

              },
              "streamHandler": {
                "backendGroupId": "string"
              },
              // end of the list of possible fields`listeners[].tls.sniHandlers[].handler`

            }
          }
        ]
      },
      "stream": {
        "handler": {
          "backendGroupId": "string"
        }
      },
      // end of the list of possible fields`listeners[]`

    }
  ],
  "allocationPolicy": {
    "locations": [
      {
        "zoneId": "string",
        "subnetId": "string",
        "disableTraffic": true
      }
    ]
  },
  "logGroupId": "string",
  "securityGroupIds": [
    "string"
  ],
  "createdAt": "string"
}

An application load balancer resource.
For details about the concept, see documentation.

Field Description
id string

ID of the application load balancer. Generated at creation time.

name string

Name of the application load balancer. The name is unique within the folder.

description string

Description of the application load balancer.

folderId string

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

labels object

Application load balancer labels as key:value pairs. For details about the concept, see documentation.

status string

Status of the application load balancer.

  • CREATING: The application load balancer is being created.
  • STARTING: The application load balancer is being started.
  • ACTIVE: The application load balancer is active and sends traffic to the targets.
  • STOPPING: The application load balancer is being stopped.
  • STOPPED: The application load balancer is stopped and doesn't send traffic to the targets.
  • DELETING: The application load balancer is being deleted.
regionId string

ID of the region that the application load balancer is located at.

networkId string

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

listeners[] object

A listener resource.

For details about the concept, see documentation.

listeners[].
name
string

Required. Name of the listener. The name is unique within the application load balancer. The string length in characters is 3-63.

listeners[].
endpoints[]
object

An endpoint resource.

listeners[].
endpoints[].
addresses[]
object

An endpoint address resource.

listeners[].
endpoints[].
addresses[].
externalIpv4Address
object
Public IPv4 endpoint address.
listeners[].endpoints[].addresses[] includes only one of the fields externalIpv4Address, internalIpv4Address, externalIpv6Address

A public (external) IPv4 endpoint address resource.

listeners[].
endpoints[].
addresses[].
externalIpv4Address.
address
string

IPv4 address.

listeners[].
endpoints[].
addresses[].
internalIpv4Address
object
Internal IPv4 endpoint address. To enable the use of listeners with internal addresses, contact support.
listeners[].endpoints[].addresses[] includes only one of the fields externalIpv4Address, internalIpv4Address, externalIpv6Address

An internal IPv4 endpoint address resource.

listeners[].
endpoints[].
addresses[].
internalIpv4Address.
address
string

IPv4 address.

listeners[].
endpoints[].
addresses[].
internalIpv4Address.
subnetId
string

ID of the subnet that the address belongs to.

listeners[].
endpoints[].
addresses[].
externalIpv6Address
object
Public IPv6 endpoint address.
listeners[].endpoints[].addresses[] includes only one of the fields externalIpv4Address, internalIpv4Address, externalIpv6Address

A public (external) IPv4 endpoint address resource.

listeners[].
endpoints[].
addresses[].
externalIpv6Address.
address
string

IPv6 address.

listeners[].
endpoints[].
ports[]
string (int64)

Required. Endpoint ports.

Must contain at least one element. Acceptable values are 1 to 65535, inclusive.

listeners[].
http
object
Unencrypted HTTP listener settings.
listeners[] includes only one of the fields http, tls, stream

An HTTP listener resource.

listeners[].
http.
handler
object

Settings for handling HTTP requests.

Only one of handler and redirects can be specified.

An HTTP handler resource.

listeners[].
http.
handler.
httpRouterId
string

ID of the HTTP router processing requests. For details about the concept, see documentation.

To get the list of all available HTTP routers, make a list request.

listeners[].
http.
handler.
http2Options
object
HTTP/2 settings. If specified, incoming HTTP/2 requests are supported by the listener.
listeners[].http.handler includes only one of the fields http2Options, allowHttp10

An HTTP/2 options resource.

listeners[].
http.
handler.
http2Options.
maxConcurrentStreams
string (int64)

Maximum number of concurrent HTTP/2 streams in a connection.

listeners[].
http.
handler.
allowHttp10
boolean (boolean)
listeners[].http.handler includes only one of the fields http2Options, allowHttp10

Enables support for incoming HTTP/1.0 and HTTP/1.1 requests and disables it for HTTP/2 requests.

listeners[].
http.
redirects
object

Redirects settings.

Only one of redirects and handler can be specified.

A listener redirects resource.

listeners[].
http.
redirects.
httpToHttps
boolean (boolean)

Redirects all unencrypted HTTP requests to the same URI with scheme changed to https.

The setting has the same effect as a single, catch-all HttpRoute with replaceScheme set to https.

listeners[].
tls
object
TLS-encrypted HTTP or TCP stream listener settings. All handlers within a listener (defaultHandler and sniHandlers) must be of one type, HttpHandler or StreamHandler. Mixing HTTP and TCP stream traffic in a TLS-encrypted listener is not supported.
listeners[] includes only one of the fields http, tls, stream

TLS-encrypted (HTTP or TCP stream) listener resource.

listeners[].
tls.
defaultHandler
object

Required. Settings for handling requests by default, with Server Name Indication (SNI) not matching any of the sniHandlers.

A TLS-encrypted (HTTP or TCP stream) handler resource.

listeners[].
tls.
defaultHandler.
certificateIds[]
string

Required. ID's of the TLS server certificates from Certificate Manager.

RSA and ECDSA certificates are supported, and only the first certificate of each type is used.

Must contain at least one element.

listeners[].
tls.
defaultHandler.
httpHandler
object
HTTP handler.
listeners[].tls.defaultHandler includes only one of the fields httpHandler, streamHandler

An HTTP handler resource.

listeners[].
tls.
defaultHandler.
httpHandler.
httpRouterId
string

ID of the HTTP router processing requests. For details about the concept, see documentation.

To get the list of all available HTTP routers, make a list request.

listeners[].
tls.
defaultHandler.
httpHandler.
http2Options
object
HTTP/2 settings. If specified, incoming HTTP/2 requests are supported by the listener.
listeners[].tls.defaultHandler.httpHandler includes only one of the fields http2Options, allowHttp10

An HTTP/2 options resource.

listeners[].
tls.
defaultHandler.
httpHandler.
http2Options.
maxConcurrentStreams
string (int64)

Maximum number of concurrent HTTP/2 streams in a connection.

listeners[].
tls.
defaultHandler.
httpHandler.
allowHttp10
boolean (boolean)
listeners[].tls.defaultHandler.httpHandler includes only one of the fields http2Options, allowHttp10

Enables support for incoming HTTP/1.0 and HTTP/1.1 requests and disables it for HTTP/2 requests.

listeners[].
tls.
defaultHandler.
streamHandler
object
Stream (TCP) handler.
listeners[].tls.defaultHandler includes only one of the fields httpHandler, streamHandler

A stream (TCP) handler resource.

listeners[].
tls.
defaultHandler.
streamHandler.
backendGroupId
string

Required. ID of the backend group processing requests. For details about the concept, see documentation.

The backend group type, specified via [BackendGroup.backend], must be stream.

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

listeners[].
tls.
sniHandlers[]
object

A SNI handler resource.

listeners[].
tls.
sniHandlers[].
name
string

Required. Name of the SNI handler.

listeners[].
tls.
sniHandlers[].
serverNames[]
string

Required. Server names that are matched by the SNI handler.

Must contain at least one element.

listeners[].
tls.
sniHandlers[].
handler
object

Required. Settings for handling requests with Server Name Indication (SNI) matching one of serverNames values.

A TLS-encrypted (HTTP or TCP stream) handler resource.

listeners[].
tls.
sniHandlers[].
handler.
certificateIds[]
string

Required. ID's of the TLS server certificates from Certificate Manager.

RSA and ECDSA certificates are supported, and only the first certificate of each type is used.

Must contain at least one element.

listeners[].
tls.
sniHandlers[].
handler.
httpHandler
object
HTTP handler.
listeners[].tls.sniHandlers[].handler includes only one of the fields httpHandler, streamHandler

An HTTP handler resource.

listeners[].
tls.
sniHandlers[].
handler.
httpHandler.
httpRouterId
string

ID of the HTTP router processing requests. For details about the concept, see documentation.

To get the list of all available HTTP routers, make a list request.

listeners[].
tls.
sniHandlers[].
handler.
httpHandler.
http2Options
object
HTTP/2 settings. If specified, incoming HTTP/2 requests are supported by the listener.
listeners[].tls.sniHandlers[].handler.httpHandler includes only one of the fields http2Options, allowHttp10

An HTTP/2 options resource.

listeners[].
tls.
sniHandlers[].
handler.
httpHandler.
http2Options.
maxConcurrentStreams
string (int64)

Maximum number of concurrent HTTP/2 streams in a connection.

listeners[].
tls.
sniHandlers[].
handler.
httpHandler.
allowHttp10
boolean (boolean)
listeners[].tls.sniHandlers[].handler.httpHandler includes only one of the fields http2Options, allowHttp10

Enables support for incoming HTTP/1.0 and HTTP/1.1 requests and disables it for HTTP/2 requests.

listeners[].
tls.
sniHandlers[].
handler.
streamHandler
object
Stream (TCP) handler.
listeners[].tls.sniHandlers[].handler includes only one of the fields httpHandler, streamHandler

A stream (TCP) handler resource.

listeners[].
tls.
sniHandlers[].
handler.
streamHandler.
backendGroupId
string

Required. ID of the backend group processing requests. For details about the concept, see documentation.

The backend group type, specified via [BackendGroup.backend], must be stream.

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

listeners[].
stream
object
Unencrypted stream (TCP) listener settings.
listeners[] includes only one of the fields http, tls, stream

A stream (TCP) listener resource.

listeners[].
stream.
handler
object

Required. Settings for handling stream (TCP) requests.

A stream (TCP) handler resource.

listeners[].
stream.
handler.
backendGroupId
string

Required. ID of the backend group processing requests. For details about the concept, see documentation.

The backend group type, specified via [BackendGroup.backend], must be stream.

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

allocationPolicy object

Locality settings of the application load balancer.

For details about the concept, see documentation.

A locality settings (allocation policy) resource.

allocationPolicy.
locations[]
object

An application load balancer location resource.

For details about the concept, see documentation.

allocationPolicy.
locations[].
zoneId
string

Required. ID of the availability zone where the application load balancer resides.

Each availability zone can only be specified once.

allocationPolicy.
locations[].
subnetId
string

ID of the subnet that the application load balancer belongs to.

allocationPolicy.
locations[].
disableTraffic
boolean (boolean)

Disables the load balancer node in the specified availability zone.

Backends in the availability zone are not directly affected by this setting. They still may receive traffic from the load balancer nodes in other availability zones, subject to localityAwareRoutingPercent and strictLocality settings.

logGroupId string

ID of the log group that stores access logs of the application load balancer.

The logs can be accessed using a Cloud Functions trigger for Cloud Logs.

securityGroupIds[] string

ID's of the security groups attributed to the application load balancer.

For details about the concept, see documentation.

createdAt string (date-time)

Creation timestamp.

String in RFC3339 text format.

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

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