community.network.ce_switchport – Управляет интерфейсами коммутационных портов второго уровня на коммутаторах HUAWEI CloudEngine.

Примечание

Этот плагин является частью коллекции community.network (версия 2.0.1).

Для его установки используйте: ansible-galaxy collection install community.network.

Для использования в книге задач укажите: community.network.ce_switchport.

Обзор
Параметры
Примечания
Примеры
Значения возврата

Обзор

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

Параметры

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

Примечания

Примечание

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

Примеры

- 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
    community.network.ce_switchport:
      interface: 10GE1/0/22
      state: unconfigured
      provider: '{{ cli }}'

  - name: Ensure 10GE1/0/22 is configured for access vlan 20
    community.network.ce_switchport:
      interface: 10GE1/0/22
      mode: access
      default_vlan: 20
      provider: '{{ cli }}'

  - name: Ensure 10GE1/0/22 only has vlans 5-10 as trunk vlans
    community.network.ce_switchport:
      interface: 10GE1/0/22
      mode: trunk
      pvid_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)
    community.network.ce_switchport:
      interface: 10GE1/0/22
      mode: trunk
      pvid_vlan: 10
      trunk_vlans: 2-50
      provider: '{{ cli }}'

  - name: Ensure these VLANs are not being tagged on the trunk
    community.network.ce_switchport:
      interface: 10GE1/0/22
      mode: trunk
      trunk_vlans: 51-4000
      state: absent
      provider: '{{ cli }}'

Значения возврата

Общие значения возврата описаны здесь, следующие являются полями, уникальными для данного модуля:

Ключ	Возвращаемое значение	Описание
changed boolean	всегда	проверка, были ли внесены изменения на устройстве Пример: True
end_state словарь	всегда	k/v пары коммутационного порта после выполнения модуля Пример: {'default_vlan': '20', 'interface': '10GE1/0/22', 'mode': 'access', 'switchport': 'enable'}
existing словарь	всегда	k/v пары существующего коммутационного порта Пример: {'default_vlan': '10', 'interface': '10GE1/0/22', 'mode': 'access', 'switchport': 'enable'}
proposed словарь	всегда	k/v пары параметров, переданных в модуль Пример: {'default_vlan': '20', 'interface': '10GE1/0/22', 'mode': 'access'}
updates список / элементы=строка	всегда	строка команды, отправленная на устройство Пример: ['10GE1/0/22', 'port default vlan 20']

Авторы

QijunPan (@QijunPan)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/network/ce_switchport_module.html