ios_interface - Управление интерфейсами на устройствах Cisco IOS
Новая версия 2.4.
Описание
- Этот модуль обеспечивает декларативное управление интерфейсами на устройствах Cisco IOS.
Параметры
| параметр | обязательно | по умолчанию | значения | комментарии | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| aggregate | нет | Список определений интерфейсов. | |||||||||||||||||
| delay | нет | 10 | Время в секундах ожидания проверки операционного состояния на удалённом устройстве. Это ожидание применимо к аргументам операционного состояния, которые являются state со значениями up/down, tx_rate и rx_rate. | ||||||||||||||||
| description | нет | Описание интерфейса. | |||||||||||||||||
| duplex | нет | auto |
| Состояние соединения интерфейса | |||||||||||||||
| enabled | нет | Состояние соединения интерфейса. | |||||||||||||||||
| mtu | нет | Максимальный размер передаваемого пакета. | |||||||||||||||||
| name | да | Имя интерфейса. | |||||||||||||||||
| neighbors | нет | Проверить операционное состояние заданного интерфейса name для соседа LLDP.Доступны следующие подпараметры. |
|||||||||||||||||
| |||||||||||||||||||
| rx_rate | нет | Скорость приёма в битах в секунду (бит/с). | |||||||||||||||||
| speed | нет | Скорость соединения интерфейса. | |||||||||||||||||
| state | нет | present |
| Состояние конфигурации интерфейса, up означает присутствие и операционное включение, а down означает присутствие и операционное down.
| |||||||||||||||
| tx_rate | нет | Скорость передачи в битах в секунду (бит/с). | |||||||||||||||||
Примеры
- name: configure interface
ios_interface:
name: GigabitEthernet0/2
description: test-interface
speed: 100
duplex: half
mtu: 512
- name: remove interface
ios_interface:
name: Loopback9
state: absent
- name: make interface up
ios_interface:
name: GigabitEthernet0/2
enabled: True
- name: make interface down
ios_interface:
name: GigabitEthernet0/2
enabled: False
- name: Check intent arguments
ios_interface:
name: GigabitEthernet0/2
state: up
tx_rate: ge(0)
rx_rate: le(0)
- name: Check neighbors intent arguments
ios_interface:
name: Gi0/0
neighbors:
- port: eth0
host: netdev
- name: Config + intent
ios_interface:
name: GigabitEthernet0/2
enabled: False
state: down
- name: Add interface using aggregate
ios_interface:
aggregate:
- { name: GigabitEthernet0/1, mtu: 256, description: test-interface-1 }
- { name: GigabitEthernet0/2, mtu: 516, description: test-interface-2 }
duplex: full
speed: 100
state: present
- name: Delete interface using aggregate
ios_interface:
aggregate:
- name: Loopback9
- name: Loopback10
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для данного модуля:
| имя | описание | возвращается | тип | пример |
|---|---|---|---|---|
| commands | Список команд конфигурационного режима для отправки на устройство. | всегда, за исключением платформ, использующих транспорт Netconf для управления устройством. | список | ['interface GigabitEthernet0/2', 'description test-interface', 'duplex half', 'mtu 512'] |
Примечания
Примечание
- Тестировалось на IOS 15.6
Статус
Этот модуль помечен как preview, что означает, что он не гарантирует обратной совместимости интерфейса.
Информация о техническом обслуживании
Для получения дополнительной информации о поддержке этого модуля компанией 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/ios_interface_module.html
