ce_switchport - Управляет интерфейсами Layer 2 switchport на коммутаторах HUAWEI CloudEngine.
Новая версия 2.4.
Описание
- Управляет интерфейсами Layer 2 switchport на коммутаторах HUAWEI CloudEngine.
Параметры
| параметр | обязательно | по умолчанию | варианты | комментарии |
|---|---|---|---|---|
| access_vlan | нет | Если mode=access, используется в качестве идентификатора VLAN доступа, в диапазоне от 1 до 4094. | ||
| interface | да | Полное имя интерфейса, например, 40GE1/0/22. | ||
| mode | нет |
| Тип подключения интерфейса. | |
| native_vlan | нет | Если mode=trunk, используется в качестве идентификатора VLAN по умолчанию для trunk, в диапазоне от 1 до 4094. | ||
| state | нет | present |
| Управление состоянием ресурса. |
| trunk_vlans | нет | Если mode=trunk, используется в качестве диапазона VLAN для добавления или удаления из trunk, например, 2-10 или 2,5,10-15 и т.д. |
Примеры
- name: switchport module test
hosts: cloudengine
connection: local
gather_facts: no
vars:
cli:
host: "{{ inventory_hostname }}"
port: "{{ ansible_ssh_port }}"
username: "{{ username }}"
password: "{{ password }}"
transport: cli
tasks:
- name: Ensure 10GE1/0/22 is in its default switchport state
ce_switchport:
interface: 10GE1/0/22
state: unconfigured
provider: '{{ cli }}'
- name: Ensure 10GE1/0/22 is configured for access vlan 20
ce_switchport:
interface: 10GE1/0/22
mode: access
access_vlan: 20
provider: '{{ cli }}'
- name: Ensure 10GE1/0/22 only has vlans 5-10 as trunk vlans
ce_switchport:
interface: 10GE1/0/22
mode: trunk
native_vlan: 10
trunk_vlans: 5-10
provider: '{{ cli }}'
- name: Ensure 10GE1/0/22 is a trunk port and ensure 2-50 are being tagged (doesn't mean others aren't also being tagged)
ce_switchport:
interface: 10GE1/0/22
mode: trunk
native_vlan: 10
trunk_vlans: 2-50
provider: '{{ cli }}'
- name: Ensure these VLANs are not being tagged on the trunk
ce_switchport:
interface: 10GE1/0/22
mode: trunk
trunk_vlans: 51-4000
state: absent
provider: '{{ cli }}'
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для данного модуля:
| имя | описание | возвращается | тип | пример |
|---|---|---|---|---|
| changed | проверка, было ли произведено изменение на устройстве | всегда | булево | True |
| end_state | k/v пары switchport после выполнения модуля | всегда | словарь | {'interface': '10GE1/0/22', 'access_vlan': '20', 'mode': 'access', 'switchport': 'enable'} |
| existing | k/v пары существующего switchport | всегда | словарь | {'interface': '10GE1/0/22', 'access_vlan': '10', 'mode': 'access', 'switchport': 'enable'} |
| proposed | k/v пары параметров, переданных в модуль | всегда | словарь | {'interface': '10GE1/0/22', 'access_vlan': '20', 'mode': 'access'} |
| updates | строка команды, отправленная на устройство | всегда | список | ['10GE1/0/22', 'port default vlan 20'] |
Примечания
Примечание
- При
state=absent, VLANы могут быть добавлены/удалены из trunk-соединений, а существующий VLAN доступа может быть «unconfigured», что приведет к наличию только VLAN 1 на этом интерфейсе. - При работе с VLAN trunk ключевые слова add/remove всегда отправляются в команде
port trunk allow-pass vlan. Используйте режим verbose, чтобы увидеть отправленные команды. - При
state=unconfigured, интерфейс будет иметь по умолчанию интерфейс Layer 2, т.е. vlan 1 в режиме доступа.
Статус
Этот модуль помечен как 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/ce_switchport_module.html