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

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

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

Описание

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

Параметры

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

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на сайте https://www.ansible.com/integrations/networks/f5.
Требуется версия программного обеспечения BIG-IP >= 12.
Модули F5 изменяют только рабочую конфигурацию продукта F5. Чтобы убедиться, что конфигурация BIG-IP сохраняется на диске, обязательно включите по крайней мере одну задачу, использующую модуль 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 строка	изменённое	Включён ли баннер или нет. Пример: True
destination строка	изменённое	Включён ли баннер или нет. Пример: True
gateway_address строка	изменённое	Включён ли баннер или нет. Пример: True
netmask строка	изменённое	Маска сети назначения. Пример: 255.255.255.255
partition строка	изменённое	Раздел, на котором была создана статическая маршрутизация. Пример: Common
pool строка	изменённое	Включён ли баннер или нет. Пример: True
reject строка	изменённое	Включён ли баннер или нет. Пример: True
route_domain целое число	изменённое	Домен маршрутизации статической маршрутизации. Пример: 1
vlan строка	изменённое	Включён ли баннер или нет. Пример: True

Статус

Этот модуль гарантирует обратную совместимость изменений интерфейса в будущем. [stableinterface]
Этот модуль поддерживается партнёром Ansible. [certified]

Авторы

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.9/modules/bigip_static_route_module.html