Spec-Zone.ru › Ansible 2.10

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

Примечание

Этот плагин входит в коллекцию community.network (версия 1.3.0).

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

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

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

Обзор

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

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
aggregate
список / элементы=строка
Список определений интерфейсов.
check_running_config
булево
    Варианты:
  • нет
  • да
Проверка текущей конфигурации. Может быть установлена как переменная среды.
Модуль будет использовать значение переменной среды (по умолчанию: True), если оно не переопределено указанием в качестве параметра модуля.
delay
целое число
Время в секундах ожидания перед проверкой операционного состояния на удаленном устройстве. Это ожидание применимо к аргументу операционного состояния, которые являются state со значениями up/down, tx_rate и rx_rate.
description
строка
Название описания.
enabled
булево
    Варианты:
  • нет
  • да
Статус соединения интерфейса
name
строка
Имя интерфейса.
neighbors
список / элементы=строка
Проверка операционного состояния заданного интерфейса name для соседа CDP/LLDP.
Доступны следующие подварианты.
host
строка
Хост соседа CDP/LLDP для данного интерфейса name.
port
строка
Порт соседа CDP/LLDP, к которому подключен данный интерфейс name.
power
словарь
Встроенное питание на портах Power over Ethernet (PoE).
by_class
строка
    Варианты:
  • 0
  • 1
  • 2
  • 3
  • 4
Диапазон от 0 до 4.
Предел мощности, основанный на значении класса для данного интерфейса name.
enabled
булево
    Варианты:
  • нет
  • да
включить/выключить poe для данного интерфейса name
limit
строка
Диапазон от 1000 до 15400|30000 мВт. Для портов PoH диапазон от 1000 до 95000 мВт.
Предел мощности, основанный на фактическом значении мощности для данного интерфейса name
priority
строка
    Варианты:
  • 1
  • 2
  • 3
Диапазон от 1 (наивысший) до 3 (наименьший).
Приоритет для управления питанием для данного интерфейса name
rx_rate
строка
Скорость приема в битах в секунду (бит/с).
Только для проверки состояния.
Поддерживает условные выражения, см. Условные выражения в сетевых модулях
speed
строка
    Варианты:
  • 10-полный
  • 10-полудуплексный
  • 100-полный
  • 100-полудуплексный
  • 1000-полный
  • 1000-полный-мастер
  • 1000-полный-ведомый
  • 10g-полный
  • 10g-полный-мастер
  • 10g-полный-ведомый
  • 2500-полный
  • 2500-полный-мастер
  • 2500-полный-ведомый
  • 5g-полный
  • 5g-полный-мастер
  • 5g-полный-ведомый
  • авто
Скорость/дуплекс соединения интерфейса.
state
строка
    Варианты:
  • есть
  • отсутствует
  • включен
  • выключен
Состояние конфигурации интерфейса, up означает присутствует и работает, а down означает присутствует и находится в состоянии down
stp
булево
    Варианты:
  • нет
  • да
Включить/выключить stp для интерфейса
tx_rate
строка
Скорость передачи в битах в секунду (бит/с).
Только для проверки состояния.
Поддерживает условные выражения, см. Условные выражения в сетевых модулях
check_running_config
булево
    Варианты:
  • нет
  • да ←
Проверка текущей конфигурации. Может быть установлена как переменная среды.
Модуль будет использовать значение переменной среды (по умолчанию: True), если оно не переопределено указанием в качестве параметра модуля.
delay
целое число
По умолчанию:
10
Время в секундах ожидания перед проверкой операционного состояния на удаленном устройстве. Это ожидание применимо к аргументу операционного состояния, которые являются state со значениями up/down, tx_rate и rx_rate.
description
строка
Название описания.
enabled
булево
    Варианты:
  • нет
  • да ←
Статус соединения интерфейса
name
строка
Имя интерфейса.
neighbors
список / элементы=строка
Проверка операционного состояния заданного интерфейса name для соседа CDP/LLDP.
Доступны следующие подварианты.
host
строка
Хост соседа CDP/LLDP для данного интерфейса name.
port
строка
Порт соседа CDP/LLDP, к которому подключен данный интерфейс name.
power
словарь
Встроенное питание на портах Power over Ethernet (PoE).
by_class
строка
    Варианты:
  • 0
  • 1
  • 2
  • 3
  • 4
Диапазон от 0 до 4.
Предел мощности, основанный на значении класса для данного интерфейса name.
enabled
булево
    Варианты:
  • нет
  • да
включить/выключить poe для данного интерфейса name
По умолчанию false.
limit
строка
Диапазон от 1000 до 15400|30000 мВт. Для портов PoH диапазон от 1000 до 95000 мВт.
Предел мощности, основанный на фактическом значении мощности для данного интерфейса name
priority
строка
    Варианты:
  • 1
  • 2
  • 3
Диапазон от 1 (наивысший) до 3 (наименьший).
Приоритет для управления питанием для данного интерфейса name
rx_rate
строка
Скорость приема в битах в секунду (бит/с).
Только для проверки состояния.
Поддерживает условные выражения, см. Условные выражения в сетевых модулях
speed
строка
    Варианты:
  • 10-полный
  • 10-полудуплексный
  • 100-полный
  • 100-полудуплексный
  • 1000-полный
  • 1000-полный-мастер
  • 1000-полный-ведомый
  • 10g-полный
  • 10g-полный-мастер
  • 10g-полный-ведомый
  • 2500-полный
  • 2500-полный-мастер
  • 2500-полный-ведомый
  • 5g-полный
  • 5g-полный-мастер
  • 5g-полный-ведомый
  • авто
Скорость/дуплекс соединения интерфейса.
state
строка
    Варианты:
  • есть ←
  • отсутствует
  • включен
  • выключен
Состояние конфигурации интерфейса, up означает присутствует и работает, а down означает присутствует и находится в состоянии down
stp
булево
    Варианты:
  • нет
  • да
Включить/выключить stp для интерфейса
tx_rate
строка
Скорость передачи в битах в секунду (бит/с).
Только для проверки состояния.
Поддерживает условные выражения, см. Условные выражения в сетевых модулях

Примечания

Примечание

  • Проверено на 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

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

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

Ключ Возвращаемое значение Описание
commands
список / элементы=строка
всегда
Список команд режима конфигурации, которые необходимо отправить устройству.

Пример:
['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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/network/icx_interface_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API