Модуль community.network.ce_switchport — Управление портами Layer 2 switchport на коммутаторах HUAWEI CloudEngine.

Примечание

Этот модуль входит в коллекцию community.network (версия 5.0.3).

Вы, возможно, уже установили эту коллекцию, если используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.network.

Чтобы использовать её в плейбуке, укажите: community.network.ce_switchport.

Описание
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

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

Псевдонимы: network.cloudengine.ce_switchport

Параметры

Параметр	Комментарии
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 доступа может быть "отключён", чтобы иметь только VLAN 1 на этом интерфейсе.
При работе с VLAN trunk ключевые слова add/remove всегда отправляются в команде port trunk allow-pass vlan. Используйте режим verbose, чтобы увидеть отправленные команды.
Если state=unconfigured, интерфейс будет иметь по умолчанию интерфейс Layer 2, то есть VLAN 1 в режиме доступа.
Для этого модуля требуется, чтобы служба netconf system была включена на удалённом управляемом устройстве.
Рекомендуемое соединение — ansible.netcommon.netconf.

Примеры

- name: Switchport module test
  hosts: cloudengine
  gather_facts: false
  vars:
    ansible_user: root
    ansible_password: PASSWORD
    ansible_connection: ansible.netcommon.netconf
    ansible_network_os: community.network.ce

  tasks:
  - name: Ensure 10GE1/0/22 is in its default switchport state
    community.network.ce_switchport:
      interface: 10GE1/0/22
      state: unconfigured

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

  - 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

  - 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

  - 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

Возвращаемые значения

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

Ключ	Описание
changed логическое	проверка внесения изменений на устройстве Возвращается: всегда Пример: `true`
end_state словарь	k/v пары switchport после выполнения модуля Возвращается: всегда Пример: `{"default_vlan": "20", "interface": "10GE1/0/22", "mode": "access", "switchport": "enable"}`
existing словарь	k/v пары существующего switchport Возвращается: всегда Пример: `{"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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/network/ce_switchport_module.html