net_interface - Управление интерфейсами на сетевых устройствах

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

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

Описание

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

Параметры

параметр	обязательный	по умолчанию	возможные значения	комментарии
aggregate	нет			Список определений интерфейсов.
delay	нет	10		Время в секундах ожидания проверки операционного состояния на удаленном устройстве. Это ожидание применимо к аргументу операционного состояния, который имеет значения `up`/`down`, tx_rate и rx_rate.
description	нет			Описание интерфейса.
duplex	нет	auto	full half auto	Состояние подключения интерфейса
enabled	нет			Настройка состояния подключения интерфейса.
mtu	нет			Максимальный размер передаваемого пакета.
name	да			Имя интерфейса.
purge	нет			Удаление интерфейсов, не определенных в параметре aggregate. Это относится только к логическим интерфейсам.
rx_rate	нет			Скорость приема в битах в секунду (бит/с).
speed	нет			Скорость подключения интерфейса.
state	нет	present	present absent up down	Состояние конфигурации интерфейса, `up` указывает на наличие и работоспособность, а `down` указывает на наличие и нерабочее состояние `down`
tx_rate	нет			Скорость передачи в битах в секунду (бит/с).

Примеры

- name: configure interface
  net_interface:
    name: ge-0/0/1
    description: test-interface

- name: remove interface
  net_interface:
    name: ge-0/0/1
    state: absent

- name: make interface up
  net_interface:
    name: ge-0/0/1
    description: test-interface
    enabled: True

- name: make interface down
  net_interface:
    name: ge-0/0/1
    description: test-interface
    enabled: False

- name: Create interface using aggregate
  net_interface:
    aggregate:
      - { name: ge-0/0/1, description: test-interface-1 }
      - { name: ge-0/0/2, description: test-interface-2 }
    speed: 1g
    duplex: full
    mtu: 512

- name: Delete interface using aggregate
  junos_interface:
    aggregate:
      - { name: ge-0/0/1 }
      - { name: ge-0/0/2 }
    state: absent

- name: Check intent arguments
  net_interface:
    name: fxp0
    state: up
    tx_rate: ge(0)
    rx_rate: le(0)

- name: Config + intent
  net_interface:
    name: fxp0
    enabled: False
    state: down

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

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

имя	описание	возвращается	тип	пример
commands	Список команд конфигурации режима, которые необходимо отправить на устройство.	всегда, за исключением платформ, которые используют транспорт Netconf для управления устройством.	список	['interface 20', 'name test-interface']

Статус

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

Информация о техническом обслуживании

Дополнительную информацию о поддержке этого модуля Red Hat см. в knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>

Для получения помощи в разработке модулей, если у вас есть такое желание, пожалуйста, прочитайте Информация о сообществе и участие в разработке, Тестирование Ansible и Разработка модулей.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/net_interface_module.html