Spec-Zone.ru › Ansible

Модуль hetzner.hcloud.load_balancer_info – Сбор информации о ваших балансировщиках нагрузки Hetzner Cloud.

Примечание

Этот модуль является частью коллекции hetzner.hcloud (версия 3.1.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install hetzner.hcloud. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.

Для использования в плейбуке укажите: hetzner.hcloud.load_balancer_info.

  • Описание
  • Требования
  • Параметры
  • См. также
  • Примеры
  • Возвращаемые значения

Описание

  • Сбор информации о ваших балансировщиках нагрузки Hetzner Cloud.

Псевдонимы: hcloud_load_balancer_info

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

  • python-dateutil >= 2.7.5
  • requests >=2.20

Параметры

Параметр

Комментарии

api_endpoint

псевдонимы: endpoint

строка

Конечная точка API для Hetzner Cloud.

Вы также можете задать этот параметр, используя переменную среды HCLOUD_ENDPOINT.

По умолчанию: "https://api.hetzner.cloud/v1"

api_token

строка / обязательно

Токен API для Hetzner Cloud.

Вы также можете задать этот параметр, используя переменную среды HCLOUD_TOKEN.

id

целое число

Идентификатор балансировщиков нагрузки, которые вы хотите получить.

Модуль завершится ошибкой, если предоставленный идентификатор недействителен.

label_selector

строка

Селектор меток для балансировщиков нагрузки, которые вы хотите получить.

name

строка

Имя балансировщиков нагрузки, которые вы хотите получить.

См. также

См. также

Документация по API Hetzner Cloud

Полная справка по API Hetzner Cloud.

Примеры

- name: Gather hcloud load_balancer infos
  hetzner.hcloud.load_balancer_info:
  register: output

- name: Print the gathered infos
  debug:
    var: output

Значения возврата

Общие значения возврата задокументированы здесь, следующие — поля, уникальные для данного модуля:

Ключ

Описание

hcloud_load_balancer_info

сложный

Информация о балансировщиках нагрузки в виде списка

Возвращается: всегда

delete_protection

булево

Истинно, если балансировщик нагрузки защищен от удаления

Возвращается: всегда

Пример: false

disable_public_interface

булево

Истинно, если общедоступный интерфейс балансировщика нагрузки отключен

Возвращается: всегда

Пример: false

id

целое число

Числовой идентификатор балансировщика нагрузки

Возвращается: всегда

Пример: 1937415

ipv4_address

строка

Общедоступный IPv4-адрес балансировщика нагрузки

Возвращается: всегда

Пример: "116.203.104.109"

ipv6_address

строка

Общедоступный IPv6-адрес балансировщика нагрузки

Возвращается: всегда

Пример: "2a01:4f8:1c1c:c140::1"

labels

словарь

Пользовательские метки (пары ключ-значение)

Возвращается: всегда

load_balancer_type

строка

Имя типа балансировщика нагрузки

Возвращается: всегда

Пример: "cx11"

location

строка

Название расположения балансировщика нагрузки

Возвращается: всегда

Пример: "fsn1"

name

строка

Имя балансировщика нагрузки

Возвращается: всегда

Пример: "my-Load-Balancer"

services

сложный

все сервисы этого балансировщика нагрузки

Возвращается: Всегда

destination_port

целое число

Порт, на который пересылается трафик, т.е. порт, на котором цели слушают и принимают подключения.

Возвращается: всегда

Пример: 80

health_check

сложный

Настройка проверок работоспособности

Возвращается: всегда

http

сложный

Дополнительная настройка проверок работоспособности с протоколами http/https

Возвращается: всегда

domain

строка

Домен, который будет установлен в заголовке HTTP HOST

Возвращается: всегда

Пример: "example.com"

path

строка

Путь, который будет попытан для доступа

Возвращается: всегда

Пример: "/"

response

строка

Ожидаемый ответ; если ответ не соответствует ожидаемому результату проверки работоспособности, целевой объект считается неработоспособным

Возвращается: всегда

END_OF_DOCUMENT_MARKER

status_codes

list / elements=string

Список кодов состояния HTTP, которые мы ожидаем получить при выполнении проверки работоспособности.

Возвращается: всегда

Пример: ["2??", "3??"]

tls

boolean

Проверить сертификат TLS, доступно только если протокол проверки работоспособности - https

Возвращается: всегда

Пример: false

interval

integer

Интервал проверок работоспособности, в секундах

Возвращается: всегда

Пример: 15

port

integer

Порт, на котором будет выполняться проверка работоспособности

Возвращается: всегда

Пример: 80

protocol

string

Протокол, по которому будут выполняться проверки работоспособности

Возвращается: всегда

Пример: "http"

retries

integer

Количество попыток, прежде чем целевой объект будет помечен как неработоспособный

Возвращается: всегда

Пример: 3

timeout

integer

Время ожидания проверок работоспособности, в секундах

Возвращается: всегда

Пример: 10

http

complex

Конфигурация для служб HTTP и HTTPS

Возвращается: всегда

certificates

list / elements=string

Список имен или ID сертификатов

Возвращается: всегда

cookie_lifetime

integer

Время жизни cookie, который будет установлен при включении sticky sessions, в секундах

Возвращается: всегда

Пример: 3600

cookie_name

string

Имя cookie, которое будет установлено при включении sticky sessions

Возвращается: всегда

Пример: "HCLBSTICKY"

redirect_http

boolean

Перенаправить трафик с порта 80 на порт 443, доступно только если протокол - https

Возвращается: всегда

Пример: false

sticky_sessions

boolean

Включить или отключить sticky_sessions

Возвращается: всегда

Пример: true

listen_port

integer

Порт, на котором работает служба, т.е. порт, к которому могут подключаться пользователи.

Возвращается: всегда

Пример: 443

protocol

string

Протокол службы

Возвращается: всегда

Пример: "http"

proxyprotocol

boolean

Включить протокол PROXY.

Возвращается: всегда

Пример: false

status

string

Статус балансировщика нагрузки

Возвращается: всегда

Пример: "running"

targets

complex

Цели балансировщика нагрузки

Возвращается: всегда

health_status

список / элементы=строка

Список статусов работоспособности служб на данной цели. Присутствует только для типов целей «сервер» и «ip».

Возвращается: если тип равен server или ip

listen_port

целое число

Порт прослушивания цели балансировщика нагрузки

Возвращается: всегда

Пример: 80

status

строка

Статус цели балансировщика нагрузки

Возвращается: всегда

Возможные значения:

  • "healthy"
  • "unhealthy"
  • "unknown"

Пример: "healthy"

ip

строка

IP выделенного сервера

Возвращается: если тип равен ip

Пример: "127.0.0.1"

label_selector

строка

Селектор меток

Возвращается: если тип равен label_selector

Пример: "application=backend"

load_balancer

строка

Название балансировщика нагрузки

Возвращается: всегда

Пример: "my-LoadBalancer"

server

строка

Имя сервера

Возвращается: если тип равен server

Пример: "my-server"

type

строка

Тип цели балансировщика нагрузки

Возвращается: всегда

Пример: "server"

use_private_ip

логическое

Направить трафик через частный IP балансировщика нагрузки через сеть Hetzner Cloud.

Балансировщик нагрузки должен быть подключен к сети. См. hetzner.hcloud.load_balancer_network

Возвращается: всегда

Пример: true

Авторы

  • Lukas Kaemmerling (@LKaemmerling)

Ссылки на коллекцию

  • Система отслеживания ошибок
  • Репозиторий (исходные коды)
  • Справочная информация по API Hetzner Cloud
  • Журнал изменений API Hetzner Cloud

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/hetzner/hcloud/load_balancer_info_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API