ce_switchport - Управляет портами коммутации уровня 2 на коммутаторах HUAWEI CloudEngine.

Новая версия 2.4.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения
Состояние
- Автор

Обзор

Управляет портами коммутации уровня 2 на коммутаторах HUAWEI CloudEngine.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
access_vlan	Значение по умолчанию: None	Если `mode=access`, используется как идентификатор VLAN доступа в диапазоне от 1 до 4094.
interface обязательно	Значение по умолчанию: None	Полное имя интерфейса, например, 40GE1/0/22.
mode	Варианты: access trunk Значение по умолчанию: None	Тип подключения интерфейса.
native_vlan	Значение по умолчанию: None	Если `mode=trunk`, используется как идентификатор основной VLAN для каналов в диапазоне от 1 до 4094.
state	Варианты: present ← absent unconfigured	Управление состоянием ресурса.
trunk_vlans	Значение по умолчанию: None	Если `mode=trunk`, используется для добавления или удаления диапазона VLAN из канала, например, 2-10 или 2,5,10-15 и т. д.

Примечания

Примечание

Когда state=absent, VLAN могут быть добавлены/удалены из каналов, а существующая VLAN доступа может быть «unconfigured», чтобы на этом интерфейсе был только VLAN 1.
При работе с VLAN каналов ключевые слова add/remove всегда отправляются в команде port trunk allow-pass vlan. Используйте режим verbose, чтобы увидеть отправленные команды.
Когда state=unconfigured, интерфейс будет иметь интерфейс уровня 2 по умолчанию, т. е. vlan 1 в режиме доступа.

Примеры

- 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 boolean	всегда	проверяет, было ли внесено изменение на устройстве Пример: True
end_state dict	всегда	пара ключ-значение интерфейса коммутации после выполнения модуля Пример: {'interface': '10GE1/0/22', 'access_vlan': '20', 'mode': 'access', 'switchport': 'enable'}
existing dict	всегда	пара ключ-значение существующего порта коммутации Пример: {'interface': '10GE1/0/22', 'access_vlan': '10', 'mode': 'access', 'switchport': 'enable'}
proposed dict	всегда	пара ключ-значение параметров, переданных в модуль Пример: {'interface': '10GE1/0/22', 'access_vlan': '20', 'mode': 'access'}
updates list	всегда	строка команды, отправленная на устройство Пример: ['10GE1/0/22', 'port default vlan 20']

Состояние

Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратной совместимости.

Автор

QijunPan (@CloudEngine-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.5/modules/ce_switchport_module.html