f5networks.f5_modules.bigip_interface – Модуль для управления физическими интерфейсами BIG-IP.

Примечание

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

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

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

Новый в версии 1.0.0: of f5networks.f5_modules

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Модуль для управления физическими интерфейсами BIG-IP.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
bundle строка		Варианты: enabled disabled not-supported	Включает или отключает возможность использования канала. Этот параметр поддерживается только на определенных аппаратных платформах и интерфейсах. Попытка включить этот параметр на `VE` или любой другой неподдерживаемой платформе/интерфейсе приведёт к ошибке выполнения модуля.
bundle_speed строка		Варианты: 100G 40G not-supported	Устанавливает скорость канала, которая применима только тогда, когда канал `yes`. Этот параметр поддерживается только на определённых аппаратных платформах и интерфейсах. Попытка включить этот параметр на `VE` или любой другой неподдерживаемой платформе/интерфейсе приведёт к ошибке выполнения модуля.
description строка			Описание, заданное пользователем.
enabled логическое		Варианты: no yes	Указывает текущий статус интерфейса. Когда `yes`, включает интерфейс для передачи трафика. Когда `no`, отключает интерфейс от передачи трафика.
flow_control строка		Варианты: none rx tx tx-rx	Указывает, как система управляет отправкой фреймов PAUSE. При `tx-rx`, интерфейс обрабатывает фреймы pause от партнёра, а также генерирует фреймы pause при необходимости. При `tx`, интерфейс игнорирует фреймы pause от партнёра, но генерирует их при необходимости. При `rx`, интерфейс обрабатывает фреймы pause от партнёра, но не генерирует фреймы pause. При (none), управление потоком отключено на интерфейсе.
force_gigabit_fiber логическое		Варианты: no yes	Включает или отключает принудительное использование интерфейса Gigabit Ethernet. При `yes` для интерфейса Gigabit Ethernet, настройки будут принудительно установлены, и не будет выполняться автоматическое согласование. При `no` будет выполняться автоматическое согласование только с единственным доступным вариантом Gigabit Ethernet.
forward_error_correction строка		Варианты: enabled disabled not-supported auto	Включает или отключает IEEE 802.3bm Clause 91 Reed-Solomon Forward Error Correction на интерфейсах 100G. Не применимо для медиа LR4. Этот параметр поддерживается только на определённых аппаратных платформах и интерфейсах. Попытка включить этот параметр на `VE` или любой другой неподдерживаемой платформе/интерфейсе приведёт к ошибке выполнения модуля.
lldp_admin строка		Варианты: disable rxonly txonly txrx	Устанавливает настройки LLDP на уровне интерфейса. При `disabled`, интерфейс не отправляет (посылает) сообщения LLDP и не принимает их от соседних устройств. При `txonly`, интерфейс отправляет сообщения LLDP соседним устройствам, но не принимает сообщения LLDP от соседних устройств. При `rxonly`, интерфейс принимает сообщения LLDP от соседних устройств, но не отправляет сообщения LLDP соседним устройствам. При `txrx`, интерфейс отправляет и принимает сообщения LLDP от соседних устройств.
lldp_tlvmap целое число			Указывает содержимое сообщения LLDP, отправляемого или получаемого. Каждый атрибут LLDP, указанный с этим параметром, является необязательным и представлен в формате Type, Length, Value (TLV). Три обязательных TLV не учитываются при расчете этого значения: `Chassis ID`, `Port ID`, и `TTL`. Доступные необязательные атрибуты имеют соответствующее числовое значение TLV. Атрибут `Port Description` имеет значение TLV `8`. Атрибут `System Name` имеет значение TLV `16`. Атрибут `System Description` имеет значение TLV `32`. Атрибут `System Capabilities` имеет значение TLV `64`. Атрибут `Management Address` имеет значение TLV `128`. Атрибут `Port VLAN ID` имеет значение TLV `256`. Атрибут `VLAN Name` имеет значение TLV `512`. Атрибут `Port and Protocol VLAN ID` имеет значение TLV `1024`. Атрибут `Protocol Identity` имеет значение TLV `2048`. Атрибут `MAC/PHY Config Status` имеет значение TLV `4096`. Атрибут `Link Aggregation` имеет значение TLV `8192`. Атрибут `Max Frame Size` имеет значение TLV `32768`. Атрибут `Product Model` имеет значение TLV `65536`. `lldp_tlvmap` — числовое значение, являющееся суммой всех значений TLV выбранных атрибутов. Установив `lldp_tlvmap` в `0`, вы удалите все атрибуты из интерфейса. Установив `lldp_tlvmap` в `114680`, вы добавите все атрибуты на интерфейс.
media_fixed строка		Варианты: 100000-FD 100000LR4-FD 10000LR-FD 10000T-FD 1000SX-FD 100TX-FD 10T-HD 20000-FD 40000LR4-FD 100000AR4-FD 100000SR4-FD 10000SFPCU-FD 1000CX-FD 1000T-FD 100TX-HD 12000-FD 21000-FD 40000SR4-FD 100000CR4-FD 10000ER-FD 10000SR-FD 1000LX-FD 1000T-HD 10T-FD 16000-FD 40000-FD 42000-FD auto no-phy	Устанавливает настройки для фиксированного (несъёмного) интерфейса. Используйте этот параметр только с комбинированным портом, чтобы указать тип медиа для фиксированного интерфейса, когда это не предпочтительный порт.
media_sfp строка		Варианты: 100000-FD 100000LR4-FD 10000LR-FD 10000T-FD 1000SX-FD 100TX-FD 10T-HD 20000-FD 40000LR4-FD 100000AR4-FD 100000SR4-FD 10000SFPCU-FD 1000CX-FD 1000T-FD 100TX-HD 12000-FD 21000-FD 40000SR4-FD 100000CR4-FD 10000ER-FD 10000SR-FD 1000LX-FD 1000T-HD 10T-FD 16000-FD 40000-FD 42000-FD auto no-phy	Устанавливает настройки для интерфейса SFP (съёмного). Используйте этот параметр только с комбинированным портом, чтобы указать тип медиа для интерфейса SFP, когда это не предпочтительный порт.
name строка / обязательно			Указывает имя интерфейса для управления.
port_fwd_mode строка		Варианты: l3 passive virtual-wire	Указывает режим работы.
prefer_port строка		Варианты: sfp fixed	Указывает, какой стороной комбинированного порта использует интерфейс, если обе стороны имеют возможность внешнего подключения. Значение по умолчанию для комбинированного порта — sfp. Не используйте этот параметр для некомбинированных портов.
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 ←	Настраивает транспортное соединение для использования при подключении к удалённому устройству.

	пользователь строка / обязательно		Имя пользователя для подключения к BIG-IP. У этого пользователя должны быть административные права на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.
	validate_certs булево	Варианты: нет да ←	Если `no`, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самозаверенными сертификатами. Вы можете опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`.
sflow словарь			Указывает настройки sFlow для интерфейса.
	poll_interval целое число		Указывает максимальный интервал между двумя опросами в секундах. Для того, чтобы это значение вступило в силу, `poll_interval_global` должно быть установлено на `no`. Допустимый диапазон: 0 - 4294967295.
	poll_interval_global булево	Варианты: нет да	Указывает, будет ли глобальная настройка интерфейса `poll_interval` переопределять настройку на уровне объекта `poll_interval`. Когда `yes`, настройка `poll_interval` не вступает в силу.
stp булево		Варианты: нет да	Включает или отключает STP.
stp_auto_edge_port булево		Варианты: нет да	Устанавливает автоматическое определение порта STP для интерфейса. Когда `yes`, система отслеживает интерфейс на наличие входящих пакетов STP, RSTP или MSTP. Если такие пакеты не получены в течение достаточного периода времени (примерно три секунды), интерфейсу автоматически присваивается статус порта края. Когда `no`, система никогда не присваивает интерфейсу статус порта края автоматически. Любая настройка STP, установленная на уровне отдельного интерфейса, применяется ко всем экземплярам spanning tree.
stp_edge_port булево		Варианты: нет да	Указывает, подключен ли интерфейс к конечной станции вместо другого моста spanning tree.
stp_link_type строка		Варианты: авто p2p совместный	Указывает тип STP-соединения для интерфейса.

Примечания

Примечание

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

Примеры

- name: Update Interface Settings
  bigip_interface:
    name: 1.1
    stp: yes
    stp_auto_edge_port: no
    stp_edge_port: yes
    stp_link_type: shared
    description: my description
    flow_control: tx
    lldp_admin: txrx
    lldp_tlvmap: 8
    force_gigabit_fiber: no
    sflow:
      - poll_interval: 10
      - poll_interval_global: no
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Disable Interface
  bigip_interface:
    name: 1.1
    enabled: no
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Change sflow interface settings
  bigip_interface:
    name: 1.1
    sflow:
      - poll_interval: 0
      - poll_interval_global: yes
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

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

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

Ключ		Возвращено	Описание
группа строка		изменилось	Включает или выключает возможность группирования. Пример: не поддерживается
скорость_группы строка		изменилось	Скорость группирования. Пример: 100Гбит/с
описание строка		изменилось	Пользовательское описание. Пример: моё описание
включено булево		изменилось	Текущий статус интерфейса. Пример: True
управление_потоком строка		изменилось	Указывает, как система управляет отправкой кадров PAUSE. Пример: tx
вынужденный_гигабитный_оптический_кабель булево		изменилось	Включает или выключает принудительное использование оптического кабеля Gigabit. Пример: True
исправленная_ошибка_передачи строка		изменилось	Включает или выключает исправление ошибок передачи. Пример: авто
lldp_админ строка		изменилось	Настройки LLDP на уровне интерфейса. Пример: txrx
lldp_tlvmap целое число		изменилось	Содержимое сообщения LLDP, отправляемого или получаемого. Пример: 136
фиксированный_носитель строка		изменилось	Настройки для фиксированного интерфейса. Пример: 100000-FD
носитель_sfp строка		изменилось	Настройки для SFP-интерфейса. Пример: 100000-FD
режим_переадресации_порта строка		изменилось	Режим работы. Пример: пассивный
предпочтительный_порт строка		изменилось	Сторона комбинированного порта, используемая интерфейсом. Пример: фиксированный
sflow сложный		изменилось	Указывает настройки sFlow для интерфейса. Пример: хеш/словарь значений
	poll_interval целое число	изменилось	Максимальный интервал в секундах между двумя опросами. Пример: 128
	poll_interval_global булево	изменилось	Глобальные настройки sFlow переопределяют. Пример: True
stp булево		изменилось	Включает или отключает STP.
stp_auto_edge_port булево		изменилось	Устанавливает автоматическое определение порта STP для интерфейса. Пример: True
stp_edge_port булево		изменилось	Указывает, подключен ли интерфейс к конечной станции вместо другого моста spanning tree.
stp_link_type строка		изменилось	Тип STP-соединения для интерфейса. Пример: совместный

Авторы

Wojciech Wypior (@wojtek0806)

© 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_interface_module.html