Модуль fortinet.fortios.fortios_firewall_ldb_monitor — настройка мониторов работоспособности балансировки нагрузки серверов в Fortinet FortiOS и FortiGate.
Примечание
Этот модуль входит в коллекцию fortinet.fortios (версия 2.5.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: fortinet.fortios.fortios_firewall_ldb_monitor.
Добавлено в fortinet.fortios 2.0.0
Краткое описание
- Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), устанавливая и изменяя параметры функции firewall и категории ldb_monitor. Перед использованием необходимо настроить источники данных для всех параметров и значений, приведенных в примерах. Проверено на FOS v6.0.0
Требования
На узле, выполняющем этот модуль, должны быть установлены следующие компоненты.
- ansible>=2.16
Параметры
Параметр | Комментарии |
|---|---|
access_token string | Аутентификация на основе токена. Токен создается в графическом интерфейсе FortiGate. |
enable_log boolean | Включить или отключить ведение журнала для задачи. Варианты:
|
firewall_ldb_monitor dictionary | Настройка мониторов работоспособности балансировки нагрузки серверов. |
|
dns_match_ip string |
Ожидаемый IP-адрес в ответе DNS-сервера. |
|
dns_protocol string |
Выберите протокол, используемый монитором проверки работоспособности DNS (UDP | TCP). Варианты:
|
|
dns_request_domain string |
Полное доменное имя, разрешаемое при проверке DNS. |
|
http_get string |
URI запроса, используемый для отправки GET-запроса и проверки работоспособности HTTP-сервера. При необходимости укажите имя узла перед первым символом «/»; оно будет использовано в заголовке HTTP Host. |
|
http_match string |
Строка для сопоставления со значением, ожидаемым в ответе на HTTP GET-запрос. |
|
http_max_redirects integer |
Максимальное допустимое число перенаправлений HTTP (0–5). |
|
interval integer |
Интервал между проверками работоспособности (5–65535 с). |
|
name string / обязательный |
Имя монитора. |
|
port integer |
Порт службы, используемый для проверки работоспособности. Если указано 0, монитор проверки работоспособности наследует порт, настроенный для сервера (0–65535). |
|
retry integer |
Количество попыток проверки работоспособности, после которого сервер считается недоступным (1–255). |
|
src_ip string |
IP-адрес источника для ldb-monitor. |
|
timeout integer |
Время ожидания ответа сервера на проверку работоспособности. По истечении этого времени проверка считается неудачной (1–255 с). |
|
type string |
Выберите тип монитора, используемый для проверки работоспособности сервера (PING | TCP | HTTP | HTTPS | DNS). Варианты:
|
member_path string | Путь к атрибуту участника, над которым выполняется операция. Если атрибутов несколько, они разделяются символом косой черты. Параметр с атрибутом member_path допускает выполнение операций с участниками. |
member_state string | Добавить или удалить участника по указанному пути к атрибуту. Если задан параметр member_state, параметр state игнорируется. Варианты:
|
state string / обязательный | Указывает, следует ли создать или удалить объект. Варианты:
|
vdom string | Виртуальный домен из числа ранее определенных. VDOM — виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство. По умолчанию: |
Примечания
Примечание
- Устаревшая библиотека fortiosapi объявлена нерекомендуемой; предпочтительный способ запуска плейбуков — httpapi
- Модуль поддерживает check_mode.
Примеры
- name: Configure server load balancing health monitors.
fortinet.fortios.fortios_firewall_ldb_monitor:
vdom: "{{ vdom }}"
state: "present"
access_token: "<your_own_value>"
firewall_ldb_monitor:
dns_match_ip: "<your_own_value>"
dns_protocol: "udp"
dns_request_domain: "<your_own_value>"
http_get: "<your_own_value>"
http_match: "<your_own_value>"
http_max_redirects: "0"
interval: "10"
name: "default_name_10"
port: "0"
retry: "3"
src_ip: "<your_own_value>"
timeout: "2"
type: "ping"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
build string | Номер сборки образа FortiGate Возвращается: всегда Пример: |
http_method string | Последний метод, использованный для передачи содержимого в FortiGate Возвращается: всегда Пример: |
http_status string | Последний результат, возвращенный FortiGate для последней выполненной операции Возвращается: всегда Пример: |
mkey string | Главный ключ (идентификатор), использованный при последнем вызове FortiGate Возвращается: при успехе Пример: |
name string | Имя таблицы, использованной для выполнения запроса Возвращается: всегда Пример: |
path string | Путь к таблице, использованной для выполнения запроса Возвращается: всегда Пример: |
revision string | Внутренний номер редакции Возвращается: всегда Пример: |
serial string | Серийный номер устройства Возвращается: всегда Пример: |
status string | Результат операции Возвращается: всегда Пример: |
vdom string | Используемый виртуальный домен Возвращается: всегда Пример: |
version string | Версия FortiGate Возвращается: всегда Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/fortinet/fortios/fortios_firewall_ldb_monitor_module.html
