f5networks.f5_modules.bigip_interface — модуль для управления физическими интерфейсами BIG-IP.
Примечание
Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.39.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Чтобы использовать коллекцию в плейбуке, укажите: f5networks.f5_modules.bigip_interface.
Добавлен в f5networks.f5_modules 1.0.0
Краткое описание
- Модуль для управления физическими интерфейсами BIG-IP.
Параметры
Параметр | Комментарии |
|---|---|
bundle строка | Включает или отключает возможность объединения. Этот параметр поддерживается только на некоторых аппаратных платформах и интерфейсах. Попытка включить этот параметр на Варианты:
|
bundle_speed строка | Задает скорость объединения; этот параметр применим только, когда объединение имеет значение Этот параметр поддерживается только на некоторых аппаратных платформах и интерфейсах. Попытка включить этот параметр на Варианты:
|
description строка | Описание, заданное пользователем. |
enabled логическое значение | Задает текущее состояние интерфейса. Если задано Если задано Варианты:
|
flow_control строка | Задает способ управления отправкой кадров PAUSE системой. Если задано Если задано Если задано Если задано (none), управление потоком на интерфейсе отключено. Варианты:
|
force_gigabit_fiber логическое значение | Включает или отключает принудительное использование гигабитного оптоволоконного носителя. Если для гигабитного оптоволоконного интерфейса задано Если задано Варианты:
|
forward_error_correction строка | Включает или отключает прямую коррекцию ошибок Reed-Solomon согласно IEEE 802.3bm Clause 91 для интерфейсов 100G. Не применимо для носителей LR4. Этот параметр поддерживается только на некоторых аппаратных платформах и интерфейсах. Попытка включить этот параметр на Варианты:
|
lldp_admin строка | Задает параметры LLDP на уровне интерфейса. Если задано Если задано Если задано Если задано Варианты:
|
lldp_tlvmap целое число | Задает содержимое отправляемого или принимаемого сообщения LLDP. Каждый атрибут LLDP, заданный этим параметром, является необязательным и представлен в формате «тип, длина, значение» (TLV). Три обязательных TLV, которые не учитываются при вычислении этого значения: Для доступных необязательных атрибутов определены соответствующие числовые значения TLV. Атрибут Атрибут Атрибут Атрибут Атрибут Атрибут Атрибут Атрибут Атрибут Атрибут Атрибут Атрибут Атрибут Атрибут Если задать для Если задать для |
media_fixed строка | Задает параметры фиксированного (неподключаемого) интерфейса. Используйте этот параметр только для комбинированного порта, чтобы указать тип носителя для фиксированного интерфейса, если он не является предпочтительным портом. Варианты:
|
media_sfp строка | Задает параметры интерфейса SFP (подключаемого). Используйте этот параметр только для комбинированного порта, чтобы указать тип носителя для интерфейса SFP, если он не является предпочтительным портом. Варианты:
|
name строка / обязательный | Задает имя интерфейса, которым необходимо управлять. |
port_fwd_mode строка | Задает режим работы. Варианты:
|
prefer_port строка | Указывает, какую сторону комбинированного порта использует интерфейс, если обе стороны могут обеспечить внешнее соединение. Значение по умолчанию для комбинированного порта — sfp. Не используйте этот параметр для портов, не являющихся комбинированными. Варианты:
|
provider словарь добавлен в f5networks.f5_modules 1.0.0 | Объект dict, содержащий сведения о подключении. |
|
auth_provider строка |
Настраивает поставщика аутентификации для получения токенов аутентификации с удаленного устройства. Этот параметр используется при работе с устройствами BIG-IQ. |
|
no_f5_teem логическое значение |
Если задано Этот параметр можно не указывать, задав переменную среды Ранее использовавшаяся переменная Варианты:
|
|
password псевдонимы: pass, pwd строка / обязательный |
Пароль учетной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную среды |
|
server строка / обязательный |
Имя узла BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную среды |
|
server_port целое число |
Порт сервера BIG-IP. Этот параметр можно не указывать, задав переменную среды По умолчанию: |
|
timeout целое число |
Задает время ожидания в секундах при подключении к сетевому устройству или отправке ему команд. Если время ожидания истечет до завершения операции, модуль выдаст ошибку. |
|
transport строка |
Настраивает транспортное подключение для соединения с удаленным устройством. Варианты:
|
|
user строка / обязательный |
Имя пользователя для подключения к BIG-IP или BIG-IQ. У этого пользователя должны быть права администратора на устройстве. Этот параметр можно не указывать, задав переменную среды |
|
validate_certs логическое значение |
Если задано Этот параметр можно не указывать, задав переменную среды Варианты:
|
sflow словарь | Задает параметры sFlow для интерфейса. |
|
poll_interval целое число |
Задает максимальный интервал между опросами в секундах. Чтобы этот параметр вступил в силу, значение Допустимый диапазон: 0–4294967295. |
|
poll_interval_global логическое значение |
Задает, переопределяет ли глобальный параметр интерфейса Если задано Варианты:
|
stp логическое значение | Включает или отключает STP. Варианты:
|
stp_auto_edge_port логическое значение | Включает автоматическое определение граничного порта STP для интерфейса. Если задано Если задано Варианты:
|
stp_edge_port логическое значение | Указывает, подключен ли интерфейс к конечной станции, а не к другому мосту связующего дерева. Варианты:
|
stp_link_type строка | Задает тип связи 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: true
stp_auto_edge_port: false
stp_edge_port: true
stp_link_type: shared
description: my description
flow_control: tx
lldp_admin: txrx
lldp_tlvmap: 8
force_gigabit_fiber: false
sflow:
- poll_interval: 10
- poll_interval_global: false
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
- name: Disable Interface
bigip_interface:
name: 1.1
enabled: false
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: true
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
bundle string | Включает или отключает поддержку объединения каналов. Возвращается: при изменении Пример: |
bundle_speed string | Скорость объединённого канала. Возвращается: при изменении Пример: |
description string | Описание, заданное пользователем. Возвращается: при изменении Пример: |
enabled boolean | Текущее состояние интерфейса. Возвращается: при изменении Пример: |
flow_control string | Определяет, как система управляет отправкой кадров PAUSE. Возвращается: при изменении Пример: |
force_gigabit_fiber boolean | Включает или отключает принудительное использование гигабитного оптоволоконного носителя. Возвращается: при изменении Пример: |
forward_error_correction string | Включает или отключает коррекцию ошибок при передаче данных (FEC). Возвращается: при изменении Пример: |
lldp_admin string | Параметры LLDP на уровне интерфейса. Возвращается: при изменении Пример: |
lldp_tlvmap integer | Содержимое отправляемого или принимаемого сообщения LLDP. Возвращается: при изменении Пример: |
media_fixed string | Параметры для интерфейса с фиксированным типом среды передачи. Возвращается: при изменении Пример: |
media_sfp string | Параметры интерфейса SFP. Возвращается: при изменении Пример: |
port_fwd_mode string | Режим работы. Возвращается: при изменении Пример: |
prefer_port string | Сторона комбинированного порта, используемая интерфейсом. Возвращается: при изменении Пример: |
sflow complex | Задаёт параметры sFlow для интерфейса. Возвращается: при изменении Пример: |
|
poll_interval integer |
Максимальный интервал в секундах между двумя опросами. Возвращается: при изменении Пример: |
|
poll_interval_global boolean |
Переопределение глобальных параметров sFlow. Возвращается: при изменении Пример: |
stp boolean | Включает или отключает STP. Возвращается: при изменении Пример: |
stp_auto_edge_port boolean | Включает автоматическое определение граничного порта STP для интерфейса. Возвращается: при изменении Пример: |
stp_edge_port boolean | Указывает, подключается ли интерфейс к конечной станции, а не к другому мосту связующего дерева. Возвращается: при изменении Пример: |
stp_link_type string | Тип канала STP для интерфейса. Возвращается: при изменении Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/f5networks/f5_modules/bigip_interface_module.html