net_interface - Управление интерфейсами на сетевых устройствах
Новая версия 2.4.
Обзор
- Этот модуль предоставляет декларативное управление интерфейсами на сетевых устройствах.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| aggregate | Список определений интерфейсов. | |
| delay | Значение по умолчанию: 10 | Время в секундах ожидания проверки операционного состояния на удалённом устройстве. Это ожидание применимо к параметрам операционного состояния, которые являются state со значениями 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'] |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как сетевой, что означает, что он поддерживается командой Ansible Network Team. Подробнее см. Техническое обслуживание и поддержка модулей.
Список других модулей, поддерживаемых командой Ansible Network Team, см. здесь.
Поддержка
Дополнительную информацию о поддержке этого модуля компанией 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.6/modules/net_interface_module.html
