junos_interface - Управление интерфейсами на устройствах Juniper JUNOS
Новое в версии 2.4.
- Обзор
- Требования (к хосту, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Обзор
- Этот модуль обеспечивает декларативное управление интерфейсами на устройствах Juniper JUNOS.
Требования (к хосту, на котором выполняется модуль)
- ncclient (>=v0.5.2)
Параметры
| параметр | обязательно | значение по умолчанию | выбор | комментарии |
|---|---|---|---|---|
| active | нет | True |
| Указывает, активна ли конфигурация или деактивирована |
| aggregate | нет | Список определений интерфейсов. | ||
| delay | нет | 10 | Время в секундах, которое следует подождать, прежде чем проверять состояние работы на удаленном устройстве. Это ожидание применимо к аргументу операционного состояния, которые являются state со значениями up/down, tx_rate и rx_rate. | |
| description | нет | Описание интерфейса. | ||
| duplex | нет | auto |
| Состояние подключения интерфейса. |
| enabled | нет | Настройка состояния подключения интерфейса. | ||
| mtu | нет | Максимальный размер передаваемого пакета. | ||
| name | да | Имя интерфейса. | ||
| rx_rate | нет | Скорость приема в битах в секунду (бит/с). | ||
| speed | нет | Скорость подключения интерфейса. | ||
| state | нет | present |
| Состояние конфигурации интерфейса, up указывает, что интерфейс присутствует и работает, а down указывает, что интерфейс присутствует и находится в состоянии down.
|
| tx_rate | нет | Скорость передачи в битах в секунду (бит/с). |
Примеры
- name: configure interface
junos_interface:
name: ge-0/0/1
description: test-interface
- name: remove interface
junos_interface:
name: ge-0/0/1
state: absent
- name: make interface down
junos_interface:
name: ge-0/0/1
enabled: False
- name: make interface up
junos_interface:
name: ge-0/0/1
enabled: True
- name: Deactivate interface config
junos_interface:
name: ge-0/0/1
state: present
active: False
- name: Activate interface config
net_interface:
name: ge-0/0/1
state: present
active: True
- name: Configure interface speed, mtu, duplex
junos_interface:
name: ge-0/0/1
state: present
speed: 1g
mtu: 256
duplex: full
- name: Create interface using aggregate
junos_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
junos_interface:
name: "{{ name }}"
state: up
tx_rate: ge(0)
rx_rate: le(0)
- name: Config + intent
junos_interface:
name: "{{ name }}"
enabled: False
state: down
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для этого модуля:
| имя | описание | возвращается | тип | пример |
|---|---|---|---|---|
| diff.prepared | Разница в конфигурации до и после применения изменений. | при изменении конфигурации и включенном параметре diff. | строка | [edit interfaces] + ge-0/0/1 { + description test-interface; + } |
Примечания
Примечание
- Для работы этого модуля на удаленном управляемом устройстве должна быть включена служба netconf.
- Тестировалось на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
Статус
Этот модуль помечен как предварительный, что означает, что он не гарантирует обратную совместимость.
Информация о техническом обслуживании
Дополнительную информацию о поддержке этого модуля компанией 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/junos_interface_module.html