cisco.iosxr.iosxr_interface – (deprecated, removed after 2022-06-01) Управление интерфейсом на устройствах Cisco IOS XR сети
Примечание
Этот плагин является частью коллекции cisco.iosxr (версия 1.2.0).
Для его установки используйте: ansible-galaxy collection install cisco.iosxr.
Для использования в playbook укажите: cisco.iosxr.iosxr_interface.
Новое в версии 1.0.0: of cisco.iosxr
УСТАРЕВШЕ
- Удалён в
-
главной версии после 2022-06-01
- Почему
-
Выпущены более новые и обновлённые модули с большей функциональностью в Ansible 2.9
- Альтернатива
-
iosxr_interfaces
Обзор
- Этот модуль предоставляет декларативное управление интерфейсами на устройствах Cisco IOS XR сети.
Примечание
У этого модуля есть соответствующий плагин действий.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- ncclient >= 0.5.3 при использовании netconf
- lxml >= 4.1.1 при использовании netconf
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| active строка |
| Указывает, находится ли интерфейс в active или preconfigured состоянии. Предварительная настройка позволяет настроить модульные карты сервисов до их вставки в маршрутизатор. При вставке карты мгновенно настраиваются. Активные карты — это те, которые уже вставлены. | |
| aggregate список / elements=словарь | Список определений интерфейсов | ||
| active строка |
| Указывает, находится ли интерфейс в active или preconfigured состоянии. Предварительная настройка позволяет настроить модульные карты сервисов до их вставки в маршрутизатор. При вставке карты мгновенно настраиваются. Активные карты — это те, которые уже вставлены. | |
| delay целое число | Время в секундах ожидания перед проверкой операционного состояния на удаленном устройстве. Это ожидание применимо к параметру операционного состояния, которые имеют значения state со значениями up/down, tx_rate и rx_rate. | ||
| description строка | Описание конфигурируемого интерфейса. | ||
| duplex строка |
| Настройка режима дуплексирования интерфейса. По умолчанию используется автоматическое согласование, если не указано иное. | |
| enabled логическое значение |
| Удаляет конфигурацию отключения, которая снимает принудительное административное отключение интерфейса, позволяя ему перейти в состояние включения или выключения. | |
| mtu строка | Устанавливает значение MTU для интерфейса. Диапазон от 64 до 65535' | ||
| name строка | Имя интерфейса для настройки в формате type + path . Пример: GigabitEthernet0/0/0/0
| ||
| rx_rate строка | Скорость приема в битах в секунду (бит/с). Этот параметр используется только для проверки состояния. Поддерживает условные выражения, см. Условные выражения в сетевых модулях
| ||
| speed строка |
| Настройка скорости интерфейса. По умолчанию используется автоматическое согласование, если не указано иное. | |
| state строка |
| Состояние конфигурации интерфейса, up означает наличие и операционное включение, а down означает наличие и операционное down
| |
| tx_rate строка | Скорость передачи в битах в секунду (бит/с). Этот параметр используется только для проверки состояния. Поддерживает условные выражения, см. Условные выражения в сетевых модулях
| ||
| delay целое число | Значение по умолчанию: 10 | Время в секундах ожидания перед проверкой операционного состояния на удаленном устройстве. Это ожидание применимо к параметру операционного состояния, которые имеют значения state со значениями up/down, tx_rate и rx_rate. | |
| description строка | Описание конфигурируемого интерфейса. | ||
| duplex строка |
| Настройка режима дуплексирования интерфейса. По умолчанию используется автоматическое согласование, если не указано иное. | |
| enabled логическое значение |
| Удаляет конфигурацию отключения, которая снимает принудительное административное отключение интерфейса, позволяя ему перейти в состояние включения или выключения. | |
| mtu строка | Устанавливает значение MTU для интерфейса. Диапазон от 64 до 65535' | ||
| name строка / обязательный | Имя интерфейса для настройки в формате type + path . Пример: GigabitEthernet0/0/0/0
| ||
| provider словарь | Устаревший Начиная с Ansible 2.5, рекомендуется использовать connection: network_cli.Дополнительную информацию см. в Руководстве по сети. Объект словаря, содержащий данные подключения. | ||
| host строка | Указывает имя или адрес хоста DNS для подключения к удаленному устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта. | ||
| password строка | Указывает пароль для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, вместо него используется значение переменной окружения ANSIBLE_NET_PASSWORD. | ||
| port целое число | Указывает порт для построения подключения к удаленному устройству. | ||
| ssh_keyfile путь | Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Это значение — путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задаче, вместо него используется значение переменной окружения ANSIBLE_NET_SSH_KEYFILE. | ||
| timeout целое число | Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истекает до завершения операции, модуль выдаст ошибку. | ||
| transport строка |
| Указывает тип транспорта подключения. | |
| username строка | Указывает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, вместо него используется значение переменной окружения ANSIBLE_NET_USERNAME. | ||
| rx_rate строка | Скорость приема в битах в секунду (бит/с). Этот параметр используется только для проверки состояния. Поддерживает условные выражения, см. Условные выражения в сетевых модулях
| ||
| speed строка |
| Настройка скорости интерфейса. По умолчанию используется автоматическое согласование, если не указано иное. | |
| state строка |
| Состояние конфигурации интерфейса, up означает наличие и операционное включение, а down означает наличие и операционное down
| |
| tx_rate строка | Скорость передачи в битах в секунду (бит/с). Этот параметр используется только для проверки состояния. Поддерживает условные выражения, см. Условные выражения в сетевых модулях
| ||
Примечания
Примечание
- Этот модуль работает с подключениями
network_cliиnetconf. См. параметры платформы IOS-XR. - Тестировалось на IOS XRv 6.1.3.
- Предварительная настройка физических интерфейсов не поддерживается с транспортом
netconf. - Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в Руководстве по сетям Ansible
- Дополнительную информацию об использовании Ansible для управления устройствами Cisco см. на странице интеграции Cisco .
Примеры
- name: configure interface
cisco.iosxr.iosxr_interface:
name: GigabitEthernet0/0/0/2
description: test-interface
speed: 100
duplex: half
mtu: 512
- name: remove interface
cisco.iosxr.iosxr_interface:
name: GigabitEthernet0/0/0/2
state: absent
- name: make interface up
cisco.iosxr.iosxr_interface:
name: GigabitEthernet0/0/0/2
enabled: true
- name: make interface down
cisco.iosxr.iosxr_interface:
name: GigabitEthernet0/0/0/2
enabled: false
- name: Create interface using aggregate
cisco.iosxr.iosxr_interface:
aggregate:
- name: GigabitEthernet0/0/0/3
- name: GigabitEthernet0/0/0/2
speed: 100
duplex: full
mtu: 512
state: present
- name: Create interface using aggregate along with additional params in aggregate
cisco.iosxr.iosxr_interface:
aggregate:
- {name: GigabitEthernet0/0/0/3, description: test-interface 3}
- {name: GigabitEthernet0/0/0/2, description: test-interface 2}
speed: 100
duplex: full
mtu: 512
state: present
- name: Delete interface using aggregate
cisco.iosxr.iosxr_interface:
aggregate:
- name: GigabitEthernet0/0/0/3
- name: GigabitEthernet0/0/0/2
state: absent
- name: Check intent arguments
cisco.iosxr.iosxr_interface:
name: GigabitEthernet0/0/0/5
state: up
delay: 20
- name: Config + intent
cisco.iosxr.iosxr_interface:
name: GigabitEthernet0/0/0/5
enabled: false
state: down
delay: 20
Значения возврата
Общие значения возврата описаны в этой документации. Следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| commands список / элементы=строка | всегда (пустой список, если нет команд для отправки) | Список команд режима конфигурации, отправленных устройству с транспортом cli
Пример: ['interface GigabitEthernet0/0/0/2', 'description test-interface', 'duplex half', 'mtu 512'] |
| xml список / элементы=строка | всегда (пустой список, если нет xml rpc для отправки) | NetConf rpc xml, отправленный устройству с транспортом netconf
Пример: ['<config xmlns:xc="urn:ietf:params:xml:ns:netconf:base:1.0"> <interface-configurations xmlns="http://cisco.com/ns/yang/Cisco-IOS-XR-ifmgr-cfg"> <interface-configuration xc:operation="merge"> <active>act</active> <interface-name>GigabitEthernet0/0/0/0</interface-name> <description>test-interface-0</description> <mtus><mtu> <owner>GigabitEthernet</owner> <mtu>512</mtu> </mtu></mtus> <ethernet xmlns="http://cisco.com/ns/yang/Cisco-IOS-XR-drivers-media-eth-cfg"> <speed>100</speed> <duplex>half</duplex> </ethernet> </interface-configuration> </interface-configurations></config>'] |
Статус
- Этот модуль будет удален в основной версии после 2022-06-01. [устарел]
- Для получения дополнительной информации см. УСТАРЕВШИЙ.
Авторы
- Ganesh Nalawade (@ganeshrn)
- Kedar Kekan (@kedarX)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/cisco/iosxr/iosxr_interface_module.html