ce_switchport — Управляет интерфейсами портов коммутаторов уровня 2 на коммутаторах HUAWEI CloudEngine.

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

Описание
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Описание

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

Параметры

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

Примечания

Примечание

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

Статус

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

Техническое обслуживание

Этот модуль помечен как общественный, что означает, что он поддерживается сообществом Ansible. Подробнее см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

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.6/modules/ce_switchport_module.html