pn_vlan — команда CLI для создания/удаления VLAN.
Новая в версии 2.2.
Описание
- Выполните команду vlan-create или vlan-delete.
- VLAN используются для изоляции сетевого трафика на уровне 2. Идентификаторы 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 bool | всегда | Указывает, вызвала ли команда CLI изменения на целевом устройстве. |
| command str | всегда | Команда CLI, выполненная на целевом узле(ах). |
| stderr список | при ошибке | Набор ответов об ошибках от команды vlan. |
| stdout список | всегда | Набор ответов от команды vlan. |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратной совместимостью.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Подробнее см. Техническое обслуживание и поддержка модулей.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- Pluribus Networks (@amitsi)
Подсказка
Если вы обнаружили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/pn_vlan_module.html