bigip_routedomain - Управление областями маршрутизации на BIG-IP

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

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

Описание

Управление областями маршрутизации на BIG-IP.

Требования

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

f5-sdk >= 3.0.9

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
bwc_policy			Контроллер пропускной способности для области маршрутизации.
connection_limit			Максимальное количество одновременных подключений, разрешенных для области маршрутизации. Установка этого значения в `0` отключает ограничения на подключения.
description			Указывает описательный текст, идентифицирующий область маршрутизации.
flow_eviction_policy			Политика удаления потоков для этой области маршрутизации. Примените политику удаления, чтобы настроить ответы на переполнения потоков и медленные потоки в области маршрутизации.
id			Уникальный целочисленный идентификатор, представляющий область маршрутизации. Это поле является обязательным при создании новой области маршрутизации. В версии 2.5 это значение больше не используется для ссылки на область маршрутизации при внесении изменений (например, при операциях обновления и удаления). Вместо этого используется параметр `name`. В версии 2.6 значение `name` станет обязательным параметром.
name (добавлено в 2.5)			Имя области маршрутизации.
parent			Указывает область маршрутизации, в которой система ищет маршрут, если не может найти его в конфигурированной области.
partition (добавлено в 2.5)		По умолчанию: "Общие"	Раздел для создания области маршрутизации. Разделы нельзя обновить после их создания.
password обязательно			Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Этот параметр можно опустить, если переменная среды `F5_PASSWORD` установлена. псевдонимы: pass, pwd
provider (добавлено в 2.5)			Объект типа dict, содержащий данные подключения.
	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`, сертификаты SSL не будут проверены. Используйте только на сайтах, находящихся под личным контролем, использующих самозаверяющие сертификаты. Этот параметр можно опустить, если переменная среды `F5_VALIDATE_CERTS` установлена.
	timeout	По умолчанию: 10	Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания истечёт до завершения операции, модуль выдаст ошибку.
	ssh_keyfile		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспортов cli. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	transport обязательно	Варианты: rest cli ←	Настраивает транспортное соединение для подключения к удалённому устройству.
routing_protocol		Варианты: BFD BGP IS-IS OSPFv2 OSPFv3 PIM RIP RIPng	Динамические протоколы маршрутизации для использования системой в области маршрутизации.
server обязательно			Хост BIG-IP. Этот параметр можно опустить, если переменная среды `F5_SERVER` установлена.
server_port (добавлено в 2.2)		По умолчанию: 443	Порт сервера BIG-IP. Этот параметр можно опустить, если переменная среды `F5_SERVER_PORT` установлена.
service_policy			Политика сервиса, которую нужно связать с областью маршрутизации.
state		Варианты: present ← absent	Определяет, должна ли существовать область маршрутизации или нет.
strict bool		Варианты: нет да	Указывает, применяет ли система ограничения на перенаправление между сетями или нет.
user обязательно			Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Этот параметр можно опустить, если переменная среды `F5_USER` установлена.
validate_certs bool (добавлено в 2.0)		Варианты: нет да ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на сайтах, находящихся под личным контролем, использующих самозаверяющие сертификаты. Этот параметр можно опустить, если переменная среды `F5_VALIDATE_CERTS` установлена.
vlans			VLANы, которые нужно использовать в области маршрутизации.

Примечания

Примечание

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

Примеры

- name: Create a route domain
  bigip_routedomain:
    name: foo
    id: 1234
    password: secret
    server: lb.mydomain.com
    state: present
    user: admin
  delegate_to: localhost

- name: Set VLANs on the route domain
  bigip_routedomain:
    name: bar
    password: secret
    server: lb.mydomain.com
    state: present
    user: admin
    vlans:
      - net1
      - foo
  delegate_to: localhost

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

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

Ключ	Возвращаемое значение	Описание
bwc_policy строка	изменено	Новый контроллер пропускной способности. Пример: /Common/foo
connection_limit целое число	изменено	Новый лимит подключений для домена маршрутизации. Пример: 100
description строка	изменено	Описание домена маршрутизации. Пример: домен маршрутизации foo
flow_eviction_policy строка	изменено	Новая политика удаления для использования с этим доменом маршрутизации. Пример: /Common/default-eviction-policy
id целое число	изменено	Идентификатор домена маршрутизации, который был изменён. Пример: 2
parent целое число	изменено	Новый родительский домен маршрутизации.
routing_protocol список	изменено	Список протоколов маршрутизации, применённых к домену маршрутизации. Пример: ['bfd', 'bgp']
service_policy строка	изменено	Новая политика сервиса для использования с этим доменом маршрутизации. Пример: /Common-my-service-policy
strict строка	изменено	Новая настройка строгой изоляции. Пример: включено
vlans список	изменено	Список новых VLAN, к которым применяется домен маршрутизации. Пример: ['/Common/http-tunnel', '/Common/socks-tunnel']

Статус

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

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

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