fortinet.fortimanager.fmgr_firewall_ldbmonitor – Настройка мониторов работоспособности балансировки нагрузки серверов.
Примечание
Этот плагин входит в коллекцию fortinet.fortimanager (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install fortinet.fortimanager.
Для использования в плейбуке укажите: fortinet.fortimanager.fmgr_firewall_ldbmonitor.
Добавлено в версии 2.10: модуля fortinet.fortimanager
Обзор
- Этот модуль позволяет настраивать устройство FortiManager.
- Примеры включают все параметры и значения, которые необходимо скорректировать, чтобы использовать данные из источников данных.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| adom строка / обязательно | параметр (adom) в запрошенном URL | ||
| bypass_validation логический тип |
| устанавливается в значение True только в том случае, когда схема модуля отличается от структуры API FortiManager, модуль продолжает выполняться без проверки параметров | |
| firewall_ldbmonitor словарь | установленные параметры верхнего уровня | ||
| http-get строка | URL, используемый для отправки запроса GET для проверки состояния HTTP-сервера. | ||
| http-match строка | Строка для сопоставления значения, ожидаемого в ответе на запрос HTTP-GET. | ||
| http-max-redirects целое число | Максимальное количество HTTP-редиректов (0 - 5, по умолчанию = 0). | ||
| interval целое число | Время между проверками работоспособности (5 - 65635 сек, по умолчанию = 10). | ||
| name строка | Имя монитора. | ||
| port целое число | Порт службы, используемый для проверки работоспособности. Если 0, монитор работоспособности наследует порт, настроенный для сервера (0 - 65635, ...) | ||
| retry целое число | Количество попыток проверки работоспособности перед тем, как сервер считается неработоспособным (1 - 255, по умолчанию = 3). | ||
| timeout целое число | Время ожидания получения ответа на проверку работоспособности от сервера. Достижение тайм-аута означает, что проверка работоспособности не удалась (1 - 255 ...) | ||
| type строка |
| Выбор типа монитора, используемого монитором работоспособности для проверки работоспособности сервера (PING | TCP | HTTP). | |
| rc_failed список / элементы=строка | список кодов rc, с которыми будут переопределены условия для отказа | ||
| rc_succeeded список / элементы=строка | список кодов rc, с которыми будут переопределены условия для успеха | ||
| state строка / обязательно |
| направление для создания, обновления или удаления объекта | |
| workspace_locking_adom строка | область, которая должна быть заблокирована для FortiManager, работающего в режиме рабочей области, значение может быть глобальным и другими, включая root | ||
| workspace_locking_timeout целое число | По умолчанию: 300 | максимальное время в секундах ожидания, пока другой пользователь не разблокирует рабочую область | |
Примечания
Примечание
- Поддержка работы в режиме блокировки рабочей области в этом модуле FortiManager, параметры верхнего уровня workspace_locking_adom и workspace_locking_timeout помогают выполнить работу.
- Для создания или обновления объекта используйте параметр state present.
- Для удаления объекта используйте параметр state absent.
- Обычно выполнение одного модуля может завершиться неудачно, когда возвращается ненулевой rc. Вы также можете переопределить условия отказа или успеха с помощью параметров rc_failed и rc_succeeded
Примеры
- hosts: fortimanager-inventory
collections:
- fortinet.fortimanager
connection: httpapi
vars:
ansible_httpapi_use_ssl: True
ansible_httpapi_validate_certs: False
ansible_httpapi_port: 443
tasks:
- name: Configure server load balancing health monitors.
fmgr_firewall_ldbmonitor:
bypass_validation: False
workspace_locking_adom: <value in [global, custom adom including root]>
workspace_locking_timeout: 300
rc_succeeded: [0, -2, -3, ...]
rc_failed: [-2, -3, ...]
adom: <your own value>
state: <value in [present, absent]>
firewall_ldbmonitor:
http-get: <value of string>
http-match: <value of string>
http-max-redirects: <value of integer>
interval: <value of integer>
name: <value of string>
port: <value of integer>
retry: <value of integer>
timeout: <value of integer>
type: <value in [ping, tcp, http, ...]>
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| request_url строка | всегда | Полный запросённый URL Пример: /sys/login/user |
| response_code целое число | всегда | Статус запроса API |
| response_message строка | всегда | Дескриптивное сообщение ответа API Пример: OK. |
Авторы
- Link Zheng (@chillancezen)
- Jie Xue (@JieX19)
- Frank Shen (@fshen01)
- Hongbin Lu (@fgtdev-hblu)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/fortinet/fortimanager/fmgr_firewall_ldbmonitor_module.html