модуль dellemc.enterprise_sonic.sonic_l2_interfaces — настройка сопоставления интерфейса с VLAN на основе режима access или trunk

Примечание

Этот модуль входит в коллекцию dellemc.enterprise_sonic (версия 3.2.0).

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

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

Чтобы использовать коллекцию в плейбуке, укажите: dellemc.enterprise_sonic.sonic_l2_interfaces.

Добавлено в dellemc.enterprise_sonic 1.0.0

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

Краткое описание

Управляет атрибутами интерфейсов уровня 2 в Enterprise SONiC Distribution от Dell Technologies.

Параметры

Параметр	Комментарии
config list / elements=dictionary	Список конфигураций интерфейсов уровня 2.
access dictionary	Настраивает параметры интерфейса для режима access.
vlan integer	Настраивает указанную VLAN в режиме access.
name string / обязательный	Полное имя интерфейса, например ‘Eth1/26’.
trunk dictionary	Настраивает параметры trunk на интерфейсе.
allowed_vlans list / elements=dictionary	Задает список разрешенных VLAN и диапазонов VLAN в режиме trunk для интерфейса.
vlan string	Настраивает указанную VLAN или диапазон VLAN в режиме trunk.
state string	Состояние, в котором должна остаться конфигурация. Варианты: `"merged"` ← (по умолчанию) `"deleted"` `"replaced"` `"overridden"`

Примечания

Примечание

Проверено на Enterprise SONiC Distribution от Dell Technologies.
Поддерживает check_mode.

Примеры

# Using "deleted" state
#
# Before state:
# -------------
#
# do show Vlan
# Q: A - Access (Untagged), T - Tagged
# NUM        Status      Q Ports
# 10         Inactive    A  Eth1/3
# 11         Inactive    T  Eth1/3
# 12         Inactive    A  Eth1/4
# 13         Inactive    T  Eth1/4
# 14         Inactive    A  Eth1/5
# 15         Inactive    T  Eth1/5
#
- name: Configures switch port of interfaces
  dellemc.enterprise_sonic.sonic_l2_interfaces:
    config:
      - name: Eth1/3
      - name: Eth1/4
    state: deleted
#
# After state:
# ------------
#
# do show Vlan
# Q: A - Access (Untagged), T - Tagged
# NUM        Status      Q Ports
# 10         Inactive
# 11         Inactive
# 12         Inactive
# 13         Inactive
# 14         Inactive    A  Eth1/5
# 15         Inactive    T  Eth1/5
#
#
# Using "deleted" state
#
# Before state:
# -------------
#
# do show Vlan
# Q: A - Access (Untagged), T - Tagged
# NUM        Status      Q Ports
# 10         Inactive    A  Eth1/3
# 11         Inactive    T  Eth1/3
# 12         Inactive    A  Eth1/4
# 13         Inactive    T  Eth1/4
# 14         Inactive    A  Eth1/5
# 15         Inactive    T  Eth1/5
#
- name: Configures switch port of interfaces
  dellemc.enterprise_sonic.sonic_l2_interfaces:
    config:
    state: deleted
#
# After state:
# do show Vlan
# Q: A - Access (Untagged), T - Tagged
# NUM        Status      Q Ports
# 10         Inactive
# 11         Inactive
# 12         Inactive
# 13         Inactive
# 14         Inactive
# 15         Inactive
#
#
# Using "deleted" state
#
# Before state:
# -------------
#
# do show Vlan
# Q: A - Access (Untagged), T - Tagged
# NUM        Status      Q Ports
# 11         Inactive    T  Ethernet12
# 12         Inactive    A  Ethernet12
# 13         Inactive    T  Ethernet12
# 14         Inactive    T  Ethernet12
# 15         Inactive    T  Ethernet12
# 16         Inactive    T  Ethernet12

- name: Delete the access vlan and a range of trunk vlans for an interface
  sonic_l2_interfaces:
    config:
      - name: Ethernet12
        access:
          vlan: 12
        trunk:
          allowed_vlans:
            - vlan: 13-16
    state: deleted

# After state:
# ------------
#
# do show Vlan
# Q: A - Access (Untagged), T - Tagged
# NUM        Status      Q Ports
# 11         Inactive    T  Ethernet12
# 12         Inactive
# 13         Inactive
# 14         Inactive
# 15         Inactive
# 16         Inactive
#
#
#
# Using "merged" state
#
# Before state:
# -------------
#
# do show Vlan
# Q: A - Access (Untagged), T - Tagged
# NUM        Status      Q Ports
# 10         Inactive
# 11         Inactive    T  Eth1/7
# 12         Inactive    T  Eth1/7
#
- name: Configures an access vlan for an interface
  dellemc.enterprise_sonic.sonic_l2_interfaces:
    config:
      - name: Eth1/3
        access:
          vlan: 10
    state: merged
#
# After state:
# ------------
#
# do show Vlan
# Q: A - Access (Untagged), T - Tagged
# NUM        Status      Q Ports
# 10         Inactive    A  Eth1/3
# 11         Inactive    T  Eth1/7
# 12         Inactive    T  Eth1/7
#
#
# Using "merged" state
#
# Before state:
# -------------
#
# do show Vlan
# Q: A - Access (Untagged), T - Tagged
# NUM        Status      Q Ports
# 10         Inactive    A  Eth1/3
# 12         Inactive
# 13         Inactive
# 14         Inactive
# 15         Inactive
# 16         Inactive
# 18         Inactive
#
- name: Modify the access vlan, add a range of trunk vlans and a single trunk vlan for an interface
  dellemc.enterprise_sonic.sonic_l2_interfaces:
    config:
      - name: Eth1/3
        access:
          vlan: 12
        trunk:
          allowed_vlans:
            - vlan: 13-16
            - vlan: 18
    state: merged
#
# After state:
# ------------
#
# do show Vlan
# Q: A - Access (Untagged), T - Tagged
# NUM        Status      Q Ports
# 10         Inactive
# 12         Inactive    A  Eth1/3
# 13         Inactive    T  Eth1/3
# 14         Inactive    T  Eth1/3
# 15         Inactive    T  Eth1/3
# 16         Inactive    T  Eth1/3
# 18         Inactive    T  Eth1/3
#
#
# Using "merged" state
#
# Before state:
# -------------
#
# do show Vlan
# Q: A - Access (Untagged), T - Tagged
# NUM        Status      Q Ports
# 10         Inactive
# 11         Inactive
# 12         Inactive    A  Eth1/4
# 13         Inactive    T  Eth1/4
# 14         Inactive    A  Eth1/5
# 15         Inactive    T  Eth1/5
#
- name: Configures switch port of interfaces
  dellemc.enterprise_sonic.sonic_l2_interfaces:
    config:
      - name: Eth1/3
        access:
          vlan: 12
        trunk:
          allowed_vlans:
            - vlan: 13
            - vlan: 14
    state: merged
#
# After state:
# ------------
#
# do show Vlan
# Q: A - Access (Untagged), T - Tagged
# NUM        Status      Q Ports
# 10         Inactive
# 11         Inactive
# 12         Inactive    A  Eth1/3
#                        A  Eth1/4
# 13         Inactive    T  Eth1/3
#                        T  Eth1/4
# 14         Inactive    A  Eth1/3
#                        A  Eth1/5
# 15         Inactive    T  Eth1/5
#
#
# Using "replaced" state
#
# Before state:
# -------------
#
# do show Vlan
# Q: A - Access (Untagged), T - Tagged
# NUM        Status      Q Ports
# 10         Inactive    A  Ethernet12
#                        A  Ethernet13
# 11         Inactive    T  Ethernet12
#                        T  Ethernet13

- name: Replace access vlan and trunk vlans for specified interfaces
  sonic_l2_interfaces:
    config:
      - name: Ethernet12
        access:
          vlan: 12
        trunk:
          allowed_vlans:
            - vlan: 13-14
      - name: Ethernet14
        access:
          vlan: 10
        trunk:
          allowed_vlans:
            - vlan: 11
            - vlan: 13-14
    state: replaced

# After state:
# ------------
#
# do show Vlan
# Q: A - Access (Untagged), T - Tagged
# NUM        Status      Q Ports
# 10         Inactive    A  Ethernet13
#                        A  Ethernet14
# 11         Inactive    T  Ethernet13
#                        T  Ethernet14
# 12         Inactive    A  Ethernet12
# 13         Inactive    T  Ethernet12
#                        T  Ethernet14
# 14         Inactive    T  Ethernet12
#                        T  Ethernet14
#
#
# Using "overridden" state
#
# Before state:
# -------------
#
# do show Vlan
# Q: A - Access (Untagged), T - Tagged
# NUM        Status      Q Ports
# 10         Inactive    A  Ethernet11
# 11         Inactive    T  Ethernet11
# 12         Inactive    A  Ethernet12
# 13         Inactive    T  Ethernet12

- name: Override L2 interfaces configuration in device with provided configuration
  sonic_l2_interfaces:
    config:
      - name: Ethernet13
        access:
          vlan: 12
        trunk:
          allowed_vlans:
            - vlan: 13-14
    state: overridden

# After state:
# ------------
#
# do show Vlan
# Q: A - Access (Untagged), T - Tagged
# NUM        Status      Q Ports
# 12         Inactive    A  Ethernet13
# 13         Inactive    T  Ethernet13
# 14         Inactive    T  Ethernet13
#
#

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

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

Ключ	Описание
after list / elements=string	Итоговая конфигурация при вызове модуля. Возвращается: при изменении Пример: `["The configuration returned is always in the same format as the parameters above.\n"]`
before list / elements=string	Конфигурация до вызова модуля. Возвращается: всегда Пример: `["The configuration returned always in the same format as the parameters above.\n"]`
commands list / elements=string	Набор команд, переданных удаленному устройству. Возвращается: всегда Пример: `["command 1", "command 2", "command 3"]`

Авторы

Niraimadaiselvam M(@niraimadaiselvamm)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/dellemc/enterprise_sonic/sonic_l2_interfaces_module.html