net_interface - Управление интерфейсом на сетевых устройствах
Новое в версии 2.4.
Обзор
- Этот модуль обеспечивает декларативное управление интерфейсами на сетевых устройствах.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| aggregate | Список определений интерфейсов. | |
| delay | По умолчанию: 10 | Время в секундах ожидания проверки операционного состояния на удаленном устройстве. Это ожидание применимо для операционного состояния, имеющего значения up/down, tx_rate и rx_rate. |
| description | Описание интерфейса. | |
| duplex |
| Состояние соединения интерфейса |
| enabled | Настройка состояния соединения интерфейса. | |
| mtu | Максимальный размер передаваемого пакета. | |
| name обязательно | Имя интерфейса. | |
| purge | По умолчанию: no | Удалить интерфейсы, не определенные в параметре aggregate. Это относится только к логическому интерфейсу. |
| rx_rate | Скорость приема в битах в секунду (бит/с). Этот параметр используется только для проверки состояния. Поддерживает условные выражения, см. Условные выражения в сетевых модулях
| |
| speed | Скорость соединения интерфейса. | |
| state |
| Состояние конфигурации интерфейса, 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 см. в этой статье базы знаний.
Автор
- Ganesh Nalawade (@ganeshrn)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/net_interface_module.html
