pn_vlan — команда CLI для создания/удаления VLAN.
Новая в версии 2.2.
Описание
- Выполните команду vlan-create или vlan-delete.
- VLAN используются для изоляции сетевого трафика на канальном уровне. Идентификаторы VLAN 0 и 4095 зарезервированы и не могут быть использованы в соответствии со стандартом IEEE 802.1Q. Диапазон настраиваемых идентификаторов VLAN составляет от 2 до 4092.
Параметры
| параметр | обязательный | значение по умолчанию | допустимые значения | комментарии |
|---|---|---|---|---|
| pn_clipassword | нет | Укажите пароль для входа, если пользователь не root. | ||
| pn_cliswitch | нет | Целевой коммутатор(ы) для выполнения команды CLI. | ||
| pn_cliusername | нет | Укажите имя пользователя для входа, если пользователь не root. | ||
| pn_description | нет | Укажите описание для VLAN. | ||
| pn_ports | нет | Указывает номер порта сетевого интерфейса коммутатора, список портов или диапазон портов. Номера портов должны быть в диапазоне от 1 до 64. | ||
| pn_scope | нет |
| Укажите область применения VLAN. Требуется для vlan-create. | |
| pn_stats | нет | Укажите, хотите ли вы собирать статистику для VLAN. Сбор статистики включен по умолчанию. | ||
| pn_untagged_ports | нет | Указывает порты, для которых пакеты без меток должны быть сопоставлены с VLAN. Пакеты без меток — это пакеты, не содержащие меток VLAN IEEE 802.1Q. | ||
| pn_vlanid | да | Укажите идентификатор VLAN. Значение должно быть в диапазоне от 2 до 4092. | ||
| state | да |
| Укажите действие. Используйте 'present' для создания VLAN и 'absent' для удаления VLAN. |
Примеры
- name: create a VLAN
pn_vlan:
state: 'present'
pn_vlanid: 1854
pn_scope: fabric
- name: delete VLANs
pn_vlan:
state: 'absent'
pn_vlanid: 1854
Значения возврата
Общие значения возврата описаны здесь Значения возврата, следующие поля уникальны для данного модуля:
| имя | описание | возвращаемое значение | тип | пример |
|---|---|---|---|---|
| changed | Указывает, произвел ли CLI изменения на целевом узле. | всегда | bool | |
| command | Команда CLI, запущенная на целевом узле(ах). | всегда | str | |
| stderr | Набор сообщений об ошибках от команды vlan. | при ошибке | список | |
| stdout | Набор ответов от команды vlan. | всегда | список |
Статус
Этот модуль помечен как preview, что означает, что его интерфейс не гарантируется обратной совместимостью.
Для помощи в разработке модулей, если у вас есть такие намерения, пожалуйста, ознакомьтесь с Информация о сообществе и участие, Тестирование 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/pn_vlan_module.html