f5networks.f5_modules.bigip_static_route – Управление статическими маршрутами на BIG-IP

Примечание

Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.7.1).

Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.

Для использования в книге задач, укажите: f5networks.f5_modules.bigip_static_route.

Новое в версии 1.0.0: из f5networks.f5_modules

Описание
Параметры
Примечания
Примеры
Значения возврата

Описание

Управление статическими маршрутами на системе BIG-IP.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
description строка			Описание, идентифицирующее маршрут.
destination строка			Указывает IP-адрес для статической записи в таблице маршрутизации. При создании нового статического маршрута это значение обязательно. Это значение нельзя изменить после его установки.
gateway_address строка			Указывает маршрутизатор, который система должна использовать для пересылки пакетов узлу или сети назначения. Также известен как адрес маршрутизатора следующего перехода. Это может быть адрес IPv4 или IPv6. Если это адрес IPv6, начинающийся с `FE80:`, адрес обрабатывается как адрес локальной связи. Это требует, чтобы параметр `vlan` также был указан.
mtu строка			Указывает определенное максимальное значение единицы передачи (MTU).
name строка / обязательно			Имя статического маршрута.
netmask строка			Маска сети для статического маршрута. При создании нового статического маршрута это значение обязательно. Это значение может быть в формате IP или CIDR. Это значение нельзя изменить после его установки.
partition строка		По умолчанию: "Common"	Раздел устройства для управления ресурсами.
pool строка			Указывает пул, через который система пересылает пакеты в пункт назначения.
provider словарь добавлен в 1.0.0 f5networks.f5_modules			Объект словаря, содержащий данные подключения.
	auth_provider строка		Настраивает поставщика аутентификации для получения токенов аутентификации с удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ.
	no_f5_teem логическое значение	Варианты: no yes	Если `yes`, данные телеметрии TEEM не отправляются в F5. Вы можете опустить этот параметр, задав переменную окружения `F5_TEEM`.
	password строка / обязательно		Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, задав переменную окружения `F5_PASSWORD`. псевдонимы: pass, pwd
	server строка / обязательно		Хост BIG-IP. Вы можете опустить этот параметр, задав переменную окружения `F5_SERVER`.
	server_port целое число	По умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, задав переменную окружения `F5_SERVER_PORT`.
	timeout целое число		Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания истечет до завершения операции, модуль выдаст ошибку.
	transport строка	Варианты: rest ←	Настраивает транспортное соединение для использования при подключении к удаленному устройству.
	user строка / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Вы можете опустить этот параметр, задав переменную окружения `F5_USER`.
	validate_certs логическое значение	Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте это только на контролируемых вами сайтах, использующих самозаверяющие сертификаты. Вы можете опустить этот параметр, задав переменную окружения `F5_VALIDATE_CERTS`.
reject логическое значение		Варианты: no yes	Указывает, что система отбрасывает пакеты, отправленные в пункт назначения.
route_domain целое число			Идентификатор домена маршрутизации системы. При создании нового статического маршрута, если это значение не указано, значение по умолчанию — `0`. Это значение нельзя изменить после его установки.
state строка		Варианты: present ← absent	Когда `present`, гарантирует, что статический маршрут существует. Когда `absent`, гарантирует, что статического маршрута нет.
vlan строка			Указывает VLAN или туннель, через который система пересылает пакеты в пункт назначения. Если `gateway_address` является адресом локальной связи IPv6, это значение требуется.

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется версия ПО BIG-IP >= 12.
Модули F5 изменяют только рабочую конфигурацию продукта F5. Чтобы убедиться, что конфигурация BIG-IP сохраняется на диске, необходимо включить по крайней мере одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения рабочей конфигурации. Обратитесь к документации модуля за правильным использованием модуля для сохранения рабочей конфигурации.

Примеры

- name: Create static route with gateway address
  bigip_static_route:
    destination: 10.10.10.10
    netmask: 255.255.255.255
    gateway_address: 10.2.2.3
    name: test-route
    provider:
      password: secret
      server: lb.mydomain.come
      user: admin
      validate_certs: no
  delegate_to: localhost

Значения возврата

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

Ключ	Возвращаемое значение	Описание
description строка	changed	Описание, идентифицирующее маршрут. Пример: Маршрут в DMZ
destination строка	changed	IP-адрес для статической записи в таблице маршрутизации. Пример: 0.0.0.0/0
gateway_address строка	changed	Маршрутизатор для использования системой при пересылке пакетов узлу или сети назначения. Пример: 10.2.2.3
netmask строка	changed	Маска сети назначения. Пример: 255.255.255.255
partition строка	changed	Раздел, на котором был создан статический маршрут. Пример: Common
pool строка	changed	Включена ли функция баннера или нет. Пример: True
reject логическое значение	changed	Указывает, что система отбрасывает пакеты, отправленные в пункт назначения. Пример: True
route_domain целое число	changed	Идентификатор домена маршрутизации системы. Пример: 1
vlan строка	changed	VLAN или туннель, через который система пересылает пакеты в пункт назначения. Пример: /Common/vlan1

Авторы

Tim Rupp (@caphrim007)

© 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/f5networks/f5_modules/bigip_static_route_module.html