net_interface – Управление интерфейсами на сетевых устройствах
Новая версия 2.4.
Обзор
- Этот модуль предоставляет декларативное управление интерфейсами на сетевых устройствах.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| aggregate - | Список определений интерфейсов. | |
| delay - | По умолчанию: 10 | Время в секундах, ожидаемое перед проверкой состояния на удалённом устройстве. Это ожидание применимо для аргументов состояния state со значениями up/down, tx_rate и rx_rate. |
| description - | Описание интерфейса. | |
| duplex - |
| Статус соединения интерфейса |
| enabled - | Настройка состояния соединения интерфейса. | |
| mtu - | Максимальный размер передаваемого пакета. | |
| name - / обязательно | Имя интерфейса. | |
| purge - | По умолчанию: "нет" | Очистка интерфейсов, не определённых в параметре aggregate. Это применимо только для логического интерфейса. |
| rx_rate - | Скорость приёма в битах в секунду (bps). Этот параметр используется только для проверки состояния. Поддерживает условные выражения, см. Условные выражения в сетевых модулях
| |
| speed - | Скорость соединения интерфейса. | |
| state - |
| Состояние конфигурации интерфейса, up указывает на присутствие и работоспособность, а down указывает на присутствие и нерабочее состояние down.
|
| tx_rate - | Скорость передачи в битах в секунду (bps). Этот параметр используется только для проверки состояния. Поддерживает условные выражения, см. Условные выражения в сетевых модулях
|
Примеры
- 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. [сеть]
Поддержка Red Hat
Дополнительную информацию о поддержке этого модуля Red Hat можно найти в этой статье базы знаний 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.7/modules/net_interface_module.html
