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

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

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

Обзор

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

Требования

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

f5-sdk >= 3.0.9
netaddr

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
description			Описание, идентифицирующее маршрут.
destination			Указывает IP-адрес для статической записи в таблице маршрутизации. При создании нового статического маршрута это значение обязательно. Это значение нельзя изменить после его задания.
gateway_address			Указывает маршрутизатор, который система должна использовать для пересылки пакетов узлу назначения или сети. Также известен как адрес следующего маршрутизатора. Может быть адресом IPv4 или IPv6. Если это адрес IPv6, начинающийся с `FE80:`, адрес будет обрабатываться как адрес локальной связи. Требуется, чтобы также был указан параметр `vlan`.
mtu			Указывает конкретный максимальный размер пакета (MTU).
name обязательно			Имя статического маршрута.
netmask			Маска сети для статического маршрута. При создании нового статического маршрута это значение обязательно. Это значение может быть в формате IP или CIDR. Это значение нельзя изменить после его задания.
password обязательно			Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Можно опустить этот параметр, если переменная среды `F5_PASSWORD` задана. псевдонимы: pass, pwd
pool			Указывает пул, через который система пересылает пакеты узлу назначения.
provider (добавлено в 2.5)		По умолчанию: Нет	Объект словаря, содержащий сведения о подключении.
	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 ←	Настраивает транспортное соединение для подключения к удаленному устройству.
reject			Указывает, что система отбрасывает пакеты, отправленные узлу назначения.
route_domain			Идентификатор домена маршрута системы. При создании нового статического маршрута, если это значение не указано, будет использовано значение по умолчанию `0`. Это значение нельзя изменить после его задания.
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 (добавлено в 2.0)		Варианты: нет да ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на контролируемых вами сайтах с самозаверяющими сертификатами. Можно опустить этот параметр, если переменная среды `F5_VALIDATE_CERTS` задана.
vlan			Указывает VLAN или туннель, через который система пересылает пакеты узлу назначения. Если `gateway_address` - это адрес локальной связи IPv6, это значение обязательно.

Примечания

Примечание

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

Примеры

- 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
    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
pool строка	изменено	Включен или выключен баннер. Пример: True
reject строка	изменено	Включен или выключен баннер. Пример: True
route_domain целое число	изменено	Домен маршрута статического маршрута. Пример: 1
vlan строка	изменено	Включен или выключен баннер. Пример: True

Статус

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

Автор

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_static_route_module.html