bigip_timer_policy - Управление политиками таймеров на BIG-IP

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

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

Обзор

Управление политиками таймеров на BIG-IP.

Требования

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

f5-sdk >= 3.0.9

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
description			Указывает описательный текст, идентифицирующий политику таймера.
name обязательно			Указывает имя политики таймера.
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 да ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на контролируемых вами сайтах, использующих самозаверяемые сертификаты. Вы можете опустить этот параметр, если переменная среды `F5_VALIDATE_CERTS` установлена.
	timeout	Значение по умолчанию: 10	Устанавливает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут превышен до завершения операции, модуль выдаст ошибку.
	ssh_keyfile		Указывает файл SSH-ключа для аутентификации подключения к удаленному устройству. Этот аргумент используется только для переводов cli. Если значение не указано в задаче, будет использовано значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	transport обязательно	Варианты: rest cli ←	Настраивает транспортное соединение для использования при подключении к удаленному устройству.
rules			Правила, которые вы хотите назначить политике таймера
	name обязательно		Имя правила.
	protocol	Варианты: all-other ah bna esp etherip gre icmp ipencap ipv6 ipv6-auth ipv6-crypt ipv6-icmp isp-ip mux ospf sctp tcp udp udplite	Указывает запись IP-протокола, для которой настраивается правило политики таймера. Это может быть протокол уровня 4 (например, `tcp`, `udp` или `sctp`. Только потоки, соответствующие настроенному протоколу, будут использовать это правило. При указании `all-other`, если нет конкретных правил ip-протокола, соответствующих потоку, поток соответствует всем остальным правилам ip-протокола. При указании правил, если этот параметр не указан, будет использоваться значение по умолчанию `all-other`.
	destination_ports		Список портов назначения для сопоставления с правилом. Укажите диапазон портов, указав начальный и конечный порты, разделенные дефисом (-). Это поле доступно только если вы выбрали протокол `sctp`, `tcp`, или `udp`.
	idle_timeout		Устанавливает таймаут бездействия в секундах для пар протокола и порта, соответствующих правилу политики таймера. Если `infinite`, указывает, что для пар протокола и порта, соответствующих правилу политики таймера, нет таймаута бездействия. При указании правил, если этот параметр не указан, будет использоваться значение по умолчанию `unspecified`.
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 да ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на контролируемых вами сайтах, использующих самозаверяемые сертификаты. Вы можете опустить этот параметр, если переменная среды `F5_VALIDATE_CERTS` установлена.

Примечания

Примечание

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

Примеры

- name: Create a timer policy
  bigip_timer_policy:
    name: timer1
    description: My timer policy
    rules:
      - name: rule1
        protocol: tcp
        idle_timeout: indefinite
        destination_ports:
          - 443
          - 80
      - name: rule2
        protocol: 200
      - name: rule3
        protocol: sctp
        idle_timeout: 200
        destination_ports:
          - 21
    password: secret
    server: lb.mydomain.com
    state: present
    user: admin
  delegate_to: localhost

- name: Remove a timer policy and all its associated rules
  bigip_timer_policy:
    name: timer1
    description: My timer policy
    password: secret
    server: lb.mydomain.com
    state: absent
    user: admin
  delegate_to: localhost

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

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

Ключ	Возвращаемое значение	Описание
description строка	изменено	Новое описание политики таймера. Пример: True

Статус

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

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом 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_timer_policy_module.html