community.network.icx_interface модуль — Управление интерфейсами на коммутаторах Ruckus ICX 7000 серии

Примечание

Этот модуль входит в коллекцию community.network (версия 5.0.3).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

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

Для использования в плейбуке укажите: community.network.icx_interface.

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

Обзор

Этот модуль предоставляет декларативное управление интерфейсами на устройствах ruckus icx.

Псевдонимы: network.icx.icx_interface

Параметры

Параметр	Комментарии
aggregate list / elements=dictionary	Список определений интерфейсов.
check_running_config boolean	Проверить текущую конфигурацию. Это может быть установлено как переменная среды. Модуль будет использовать значение переменной среды (по умолчанию: True), если оно не переопределено, указав его как параметр модуля. Варианты: `false` `true`
delay integer	Время в секундах ожидания перед проверкой оперативного состояния на удаленном устройстве. Это ожидание применимо для аргумента оперативного состояния, которые являются state со значениями `up`/`down`, tx_rate и rx_rate.
description string	Имя описания.
enabled boolean	Статус интерфейсного соединения Варианты: `false` `true`
name string	Имя интерфейса.
neighbors list / elements=dictionary	Проверить оперативное состояние данного интерфейса `name` для соседа CDP/LLDP. Доступны следующие дополнительные параметры.
host string	Хост соседа CDP/LLDP для данного интерфейса `name`.
port string	Порт соседа CDP/LLDP, к которому подключен данный интерфейс `name`.
power dictionary	Встроенное питание на портах Power over Ethernet (PoE).
by_class string	Диапазон от 0 до 4 Предел мощности на основе значения класса для данного интерфейса `name` Варианты: `"0"` `"1"` `"2"` `"3"` `"4"`
enabled boolean	Включить/отключить PoE для данного интерфейса `name` Варианты: `false` `true`
limit string	Диапазон от 1000 до 15400\|30000 мВт. Для портов PoH диапазон составляет от 1000 до 95000 мВт Предел мощности на основе фактического значения мощности для данного интерфейса `name`
priority string	Диапазон от 1 (наивысший) до 3 (наименьший) Приоритет для управления питанием или данного интерфейса `name` Варианты: `"1"` `"2"` `"3"`
rx_rate string	Скорость приема в битах в секунду (бит/с). Это параметр проверки состояния только. Поддерживает условные выражения, см. Условные выражения в сетевых модулях
speed string	Скорость/дуплекс интерфейсного соединения Варианты: `"10-full"` `"10-half"` `"100-full"` `"100-half"` `"1000-full"` `"1000-full-master"` `"1000-full-slave"` `"10g-full"` `"10g-full-master"` `"10g-full-slave"` `"2500-full"` `"2500-full-master"` `"2500-full-slave"` `"5g-full"` `"5g-full-master"` `"5g-full-slave"` `"auto"`
state string	Состояние конфигурации интерфейса, `up` означает присутствует и оперативно работает, а `down` означает присутствует и оперативно `down` Варианты: `"present"` `"absent"` `"up"` `"down"`
stp boolean	Включить/отключить STP для интерфейса Варианты: `false` `true`
tx_rate string	Скорость передачи в битах в секунду (бит/с). Это параметр проверки состояния только. Поддерживает условные выражения, см. Условные выражения в сетевых модулях

check_running_config boolean	Проверка текущей конфигурации. Это можно задать как переменную среды. Модуль будет использовать значение переменной среды (по умолчанию: True), если оно не переопределено указанием в качестве параметра модуля. Варианты: `false` `true` ← (по умолчанию)
delay integer	Время в секундах, ожидаемое перед проверкой оперативного состояния на удаленном устройстве. Это ожидание применимо к аргументу оперативного состояния, которые являются state со значениями `up`/`down`, tx_rate и rx_rate. По умолчанию: `10`
description string	Имя описания.
enabled boolean	Статус подключения интерфейса Варианты: `false` `true` ← (по умолчанию)
name string	Имя интерфейса.
neighbors list / elements=dictionary	Проверка оперативного состояния данного интерфейса `name` для соседнего устройства CDP/LLDP. Доступны следующие параметры.
host string	Хост соседнего устройства CDP/LLDP для данного интерфейса `name`.
port string	Порт соседнего устройства CDP/LLDP, к которому подключен данный интерфейс `name`.
power dictionary	Включение питания по технологии PoE (Power over Ethernet) на портах.
by_class string	Диапазон от 0 до 4 Предел мощности, основанный на значении класса для данного интерфейса `name`. Варианты: `"0"` `"1"` `"2"` `"3"` `"4"`
enabled boolean	Включение/выключение PoE для данного интерфейса `name`. По умолчанию значение false. Варианты: `false` `true`
limit string	Диапазон от 1000 до 15400\|30000 мВт. Для портов PoH диапазон от 1000 до 95000 мВт. Предел мощности, основанный на фактическом значении мощности для данного интерфейса `name`.
priority string	Диапазон от 1 (наивысший) до 3 (наименьший). Приоритет для управления питанием данного интерфейса `name`. Варианты: `"1"` `"2"` `"3"`
rx_rate string	Скорость приема в битах в секунду (бит/с). Только для проверки состояния. Поддерживает условные выражения, см. Условные выражения в сетевых модулях
speed string	Скорость/дуплекс интерфейса Варианты: `"10-full"` `"10-half"` `"100-full"` `"100-half"` `"1000-full"` `"1000-full-master"` `"1000-full-slave"` `"10g-full"` `"10g-full-master"` `"10g-full-slave"` `"2500-full"` `"2500-full-master"` `"2500-full-slave"` `"5g-full"` `"5g-full-master"` `"5g-full-slave"` `"auto"`
state string	Состояние конфигурации интерфейса, `up` означает присутствие и рабочее состояние, `down` означает присутствие и нерабочее `down` состояние. Варианты: `"present"` ← (по умолчанию) `"absent"` `"up"` `"down"`
stp boolean	Включение/выключение STP для интерфейса Варианты: `false` `true`
tx_rate string	Скорость передачи в битах в секунду (бит/с). Только для проверки состояния. Поддерживает условные выражения, см. Условные выражения в сетевых модулях

Примечания

Примечание

Проверено на ICX 10.1.
Для получения информации об использовании платформы ICX см. руководство по параметрам платформы ICX OS.

Примеры

- name: Enable ethernet port and set name
  community.network.icx_interface:
    name: ethernet 1/1/1
    description: interface-1
    stp: true
    enabled: true

- name: Disable ethernet port 1/1/1
  community.network.icx_interface:
      name: ethernet 1/1/1
      enabled: false

- name: Enable ethernet port range, set name and speed
  community.network.icx_interface:
      name: ethernet 1/1/1 to 1/1/10
      description: interface-1
      speed: 100-full
      enabled: true

- name: Enable poe. Set class
  community.network.icx_interface:
      name: ethernet 1/1/1
      power:
       by_class: 2

- name: Configure poe limit of interface
  community.network.icx_interface:
      name: ethernet 1/1/1
      power:
       limit: 10000

- name: Disable poe of interface
  community.network.icx_interface:
      name: ethernet 1/1/1
      power:
       enabled: false

- name: Set lag name for a range of lags
  community.network.icx_interface:
      name: lag 1 to 10
      description: test lags

- name: Disable lag
  community.network.icx_interface:
      name: lag 1
      enabled: false

- name: Enable management interface
  community.network.icx_interface:
      name: management 1
      enabled: true

- name: Enable loopback interface
  community.network.icx_interface:
      name: loopback 10
      enabled: true

- name: Add interface using aggregate
  community.network.icx_interface:
      aggregate:
      - { name: ethernet 1/1/1, description: test-interface-1, power: { by_class: 2 } }
      - { name: ethernet 1/1/3, description: test-interface-3}
      speed: 10-full
      enabled: true

- name: Check tx_rate, rx_rate intent arguments
  community.network.icx_interface:
    name: ethernet 1/1/10
    state: up
    tx_rate: ge(0)
    rx_rate: le(0)

- name: Check neighbors intent arguments
  community.network.icx_interface:
    name: ethernet 1/1/10
    neighbors:
    - port: 1/1/5
      host: netdev

Значения возврата

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

Ключ	Описание
команды список / элементы=строка	Список команд конфигурации режима, которые нужно отправить устройству. Возвращается: всегда Пример: `["interface ethernet 1/1/1", "port-name interface-1", "state present", "speed-duplex 100-full", "inline power priority 1"]`

Авторы

Ruckus Wireless (@Commscope)

Ссылки на коллекции

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/network/icx_interface_module.html