cnos_interface – Управление интерфейсами на сетевых устройствах Lenovo CNOS
Новая в версии 2.3.
Обзор
- Этот модуль предоставляет декларативное управление интерфейсами на сетевых устройствах Lenovo CNOS.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| aggregate - добавлено в 2.8 | Список определений интерфейсов. | ||
| delay - добавлено в 2.8 | По умолчанию: 20 | Время в секундах ожидания проверки оперативного состояния на удаленном устройстве. Это ожидание применимо к аргументу оперативного состояния, которые являются state со значениями up/down, tx_rate и rx_rate
| |
| description - добавлено в 2.8 | Описание интерфейса. | ||
| duplex - добавлено в 2.8 |
| Состояние соединения интерфейса | |
| enabled boolean добавлено в 2.8 |
| Состояние соединения интерфейса. | |
| mtu - добавлено в 2.8 | Максимальный размер передаваемого пакета. | ||
| name - / обязательно добавлено в 2.8 | Имя интерфейса. | ||
| neighbors - добавлено в 2.8 | Проверка оперативного состояния указанного интерфейса name для соседа LLDP.Доступны следующие подварианты. | ||
| host - | Хост соседа LLDP для данного интерфейса name. | ||
| port - | Порт соседа LLDP, к которому подключен интерфейс name. | ||
| provider - добавлено в 2.8 | Устарело Начиная с Ansible 2.5, рекомендуется использовать connection: network_cli. Для получения дополнительной информации см. руководство CNOS Platform Options. Объект словаря, содержащий данные соединения. | ||
| auth_pass - | Указывает пароль для использования при входе в привилегированный режим на удаленном устройстве. Если authorize равно false, этот аргумент не имеет значения. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_AUTH_PASS. | ||
| authorize boolean |
| Инструктирует модуль войти в привилегированный режим на удаленном устройстве перед отправкой любых команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_AUTHORIZE. | |
| host - / обязательно | Указывает имя хоста DNS или адрес для подключения к удаленному устройству через указанный транспорт. Значение хоста используется в качестве адреса назначения для транспорта. | ||
| password - | Указывает пароль для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сессии SSH. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_PASSWORD. | ||
| port - | По умолчанию: 22 | Указывает порт для подключения к удаленному устройству. | |
| ssh_keyfile - | Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Это значение — путь к ключу, используемому для аутентификации сессии SSH. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_SSH_KEYFILE. | ||
| timeout - | По умолчанию: 10 | Указывает тайм-аут в секундах для связи с сетевым устройством для подключения или отправки команд. Если тайм-аут превышен до завершения операции, модуль выдаст ошибку. | |
| username - | Указывает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сессии SSH. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_USERNAME. | ||
| rx_rate - добавлено в 2.8 | Скорость приёма в битах в секунду (bps). Этот параметр используется только для проверки состояния. Поддерживает условные выражения, см. Условные выражения в сетевых модулях
| ||
| speed - добавлено в 2.8 | Скорость соединения интерфейса. | ||
| state - добавлено в 2.8 |
| Состояние конфигурации интерфейса, up означает присутствие и оперативное подключение, а down означает присутствие и оперативное down
| |
| tx_rate - добавлено в 2.8 | Скорость передачи в битах в секунду (bps). Этот параметр используется только для проверки состояния. Поддерживает условные выражения, см. Условные выражения в сетевых модулях
| ||
Примечания
Примечание
- Проверено на CNOS 10.8.1
Примеры
- name: configure interface
cnos_interface:
name: Ethernet1/33
description: test-interface
speed: 100
duplex: half
mtu: 999
- name: remove interface
cnos_interface:
name: loopback3
state: absent
- name: make interface up
cnos_interface:
name: Ethernet1/33
enabled: True
- name: make interface down
cnos_interface:
name: Ethernet1/33
enabled: False
- name: Check intent arguments
cnos_interface:
name: Ethernet1/33
state: up
tx_rate: ge(0)
rx_rate: le(0)
- name: Check neighbors intent arguments
cnos_interface:
name: Ethernet1/33
neighbors:
- port: eth0
host: netdev
- name: Config + intent
cnos_interface:
name: Ethernet1/33
enabled: False
state: down
- name: Add interface using aggregate
cnos_interface:
aggregate:
- { name: Ethernet1/33, mtu: 256, description: test-interface-1 }
- { name: Ethernet1/44, mtu: 516, description: test-interface-2 }
duplex: full
speed: 100
state: present
- name: Delete interface using aggregate
cnos_interface:
aggregate:
- name: loopback3
- name: loopback6
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны в данном разделе, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| commands список | всегда, за исключением платформ, которые используют транспорт Netconf для управления устройством. | Список команд конфигурации для отправки на устройство. Пример: ['interface Ethernet1/33', 'description test-interface', 'duplex half', 'mtu 512'] |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [preview]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Anil Kumar Muraleedharan(@amuraleedhar)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/cnos_interface_module.html