bigip_profile_udp - Управление профилями UDP на BIG-IP

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

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

Обзор

Управление профилями UDP на BIG-IP. Существует множество профилей UDP, каждый со своими настройками по отношению к стандартному профилю udp. Пользователи данного модуля должны понимать, что многие регулируемые параметры не имеют значения по умолчанию для модуля. Вместо этого значение по умолчанию задается самой системой BIG-IP, что в большинстве случаев приемлемо.

Требования

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

f5-sdk >= 3.0.9

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
datagram_load_balancing bool		Варианты: no yes	Указывает, когда `yes`, что система распределяет нагрузку UDP по пакетам.
idle_timeout			Указывает время бездействия соединения (без трафика), после которого соединение может быть удалено. При создании нового профиля, если этот параметр не указан, удаленное устройство выберет значение по умолчанию, соответствующее профилю, на основе его `parent` профиля. При указании числа, указывает количество секунд, в течение которых соединение UDP может оставаться бездействующим, прежде чем система удалит его. Если `0`, или `indefinite`, указывает, что соединения UDP могут оставаться бездействующими неопределенно долго. Если `immediate`, указывает, что вы не хотите, чтобы UDP-соединение оставалось бездействующим, и поэтому оно сразу же подлежит удалению.
name обязательно			Указывает имя профиля.
parent			Указывает профиль, из которого этот профиль наследует настройки. При создании нового профиля, если этот параметр не указан, значение по умолчанию — системный `udp` профиль.
partition		Значение по умолчанию: "Common"	Раздел устройства для управления ресурсами.
password обязательно			Пароль учетной записи пользователя для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_PASSWORD` задана. псевдонимы: pass, pwd
provider (добавлен в 2.5)			Объект словаря, содержащий данные подключения.
	password обязательно		Пароль учетной записи пользователя для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_PASSWORD` задана. псевдонимы: pass, pwd
	server обязательно		Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER` задана.
	server_port	Значение по умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER_PORT` задана.
	user обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Вы можете опустить этот параметр, если переменная среды `F5_USER` задана.
	validate_certs bool	Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на сайтах под вашим контролем с самозаверенными сертификатами. Вы можете опустить этот параметр, если переменная среды `F5_VALIDATE_CERTS` задана.
	timeout	Значение по умолчанию: 10	Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут превышен до завершения операции, модуль выдаст ошибку.
	ssh_keyfile		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспортов cli. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	transport обязательно	Варианты: rest cli ←	Настраивает транспортное подключение для подключения к удаленному устройству.
server обязательно			Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER` задана.
server_port (добавлен в 2.2)		Значение по умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER_PORT` задана.
state		Варианты: present ← absent	Если `present`, гарантирует существование профиля. Если `absent`, гарантирует удаление профиля.
user обязательно			Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Вы можете опустить этот параметр, если переменная среды `F5_USER` задана.
validate_certs bool (добавлен в 2.0)		Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на сайтах под вашим контролем с самозаверенными сертификатами. Вы можете опустить этот параметр, если переменная среды `F5_VALIDATE_CERTS` задана.

Примечания

Примечание

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

Примеры

- name: Create a TCP profile
  bigip_profile_tcp:
    name: foo
    parent: udp
    idle_timeout: 300
    datagram_load_balancing: no
    password: secret
    server: lb.mydomain.com
    state: present
    user: admin
  delegate_to: localhost

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

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

Ключ	Возвращаемое	Описание
datagram_load_balancing bool	changed	Новое значение балансировки нагрузки для UDP-трафика. Пример: True
idle_timeout int	changed	Новое значение таймаута бездействия для ресурса. Пример: 100
parent string	changed	Новый родительский ресурс. Пример: udp

Статус

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

Обслуживание

Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. См. Поддержка и обслуживание модулей для получения дополнительной информации.

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

Автор

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.6/modules/bigip_profile_udp_module.html