bigip_monitor_udp - Управление мониторами UDP F5 BIG-IP LTM

Новое в версии 2.5.

Описание
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
- Автор

Описание

Управление мониторами UDP F5 BIG-IP LTM.

Требования

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

f5-sdk >= 3.0.9

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
interval			Интервал, определяющий частоту выполнения экземпляра монитора этой шаблона. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет 5. Это значение должно быть меньше `timeout`.
ip			IP-адрес, часть определения IP/порт. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет '*'.
name обязательно			Имя монитора.
parent		По умолчанию: /Common/udp	Родительский шаблон этого шаблона монитора. После установки этого значения его нельзя изменить. По умолчанию это значение равно родительскому `udp` на разделяемой `Common`.
partition (добавлено в 2.5)		По умолчанию: Common	Раздел устройства для управления ресурсами.
password обязательно			Пароль учетной записи пользователя для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_PASSWORD` установлена. псевдонимы: pass, pwd
port			Порт, часть определения IP/порт. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет '*'. Обратите внимание, что если указан IP-адрес, необходимо указать значение от 1 до 65535.
provider (добавлено в 2.5)		По умолчанию: None	Объект словаря, содержащий данные подключения.
	ssh_keyfile		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспорта cli. Если значение не указано в задаче, будет использоваться значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout	По умолчанию: 10	Устанавливает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истекает до завершения операции, модуль вернет ошибку.
	server обязательно		Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER` установлена.
	user обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, если переменная среды `F5_USER` установлена.
	server_port	По умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER_PORT` установлена.
	password обязательно		Пароль учетной записи пользователя для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_PASSWORD` установлена. псевдонимы: pass, pwd
	validate_certs	Варианты: нет да ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на сайтах под вашим контролем, использующих самозаверенные сертификаты. Вы можете опустить этот параметр, если переменная среды `F5_VALIDATE_CERTS` установлена.
	transport обязательно	Варианты: rest cli ←	Настройка транспорта подключения для подключения к удаленному устройству.
receive			Строка приема для вызова монитора.
receive_disable			Эта настройка работает так же, как `receive`, за исключением того, что система помечает узел или члена пула как отключенным, когда его ответ соответствует строке `receive_disable`, но не `receive`. Для использования этой настройки необходимо указать как `receive_disable`, так и `receive`.
send			Строка отправки для вызова монитора. При создании нового монитора, если это значение не указано, используется значение по умолчанию `default send string`.
server обязательно			Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER` установлена.
server_port (добавлено в 2.2)		По умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER_PORT` установлена.
state (добавлено в 2.5)		Варианты: present ← absent	При `present`, гарантирует, что монитор существует. При `absent`, гарантирует удаление монитора.
time_until_up			Устанавливает количество секунд после первого успешного ответа, прежде чем узел будет помечен как активный. Значение 0 приведет к тому, что узел будет помечен как активный сразу после получения корректного ответа от узла. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет 0.
timeout			Количество секунд, в течение которого узел или служба должны ответить на запрос монитора. Если целевой объект отвечает в установленный период времени, он считается активным. Если целевой объект не отвечает в течение установленного периода времени, он считается неактивным. Вы можете изменить это значение на любое нужное вам число, но оно должно быть в 3 раза больше числа интервалов в секундах плюс 1 секунда. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет 16.
user обязательно			Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, если переменная среды `F5_USER` установлена.
validate_certs (добавлено в 2.0)		Варианты: нет да ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на сайтах под вашим контролем, использующих самозаверенные сертификаты. Вы можете опустить этот параметр, если переменная среды `F5_VALIDATE_CERTS` установлена.

Примечания

Примечание

Требуется версия ПО BIG-IP >= 12
Дополнительную информацию о использовании Ansible для управления устройствами F5 Networks см. на сайте https://www.ansible.com/integrations/networks/f5.
Требуется пакет f5-sdk Python на хосте. Это так же просто, как pip install f5-sdk.

Примеры

- name: Create UDP Monitor
  bigip_monitor_udp:
    state: present
    ip: 10.10.10.10
    server: lb.mydomain.com
    user: admin
    password: secret
    name: my_udp_monitor
  delegate_to: localhost

- name: Remove UDP Monitor
  bigip_monitor_udp:
    state: absent
    server: lb.mydomain.com
    user: admin
    password: secret
    name: my_udp_monitor
  delegate_to: localhost

Возвращаемые значения

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

Ключ	Возвращаемое значение	Описание
interval int	изменённое	Новый интервал, в котором будет выполняться проверка монитора. Пример: 2
ip string	изменённое	Новый IP-адрес определения IP/порта. Пример: 10.12.13.14
parent string	изменённое	Новая родительская шаблон монитора. Пример: http
time_until_up int	изменённое	Новое время, в течение которого система будет помечена как «активная» после первого успешного ответа. Пример: 2
timeout int	изменённое	Новый таймаут, в течение которого удалённая система должна ответить на монитор. Пример: 10

Статус

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

Автор

Tim Rupp (@caphrim007)

Подсказка

Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/bigip_monitor_udp_module.html