Модуль dellemc.enterprise_sonic.sonic_port_group — управление конфигурацией групп портов в SONiC.

Примечание

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

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

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

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

Новая возможность в dellemc.enterprise_sonic 2.1.0

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

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

Этот модуль управляет конфигурацией групп портов на устройствах под управлением SONiC.

Параметры

Параметр	Комментарии
config list / elements=dictionary	Список конфигураций групп портов.
id string / обязательный	Индекс группы портов.
speed string	Скорость группы портов. Этот параметр задаёт скорость для всех портов-участников группы. Поддерживаемые скорости зависят от типа коммутатора. Варианты: `"SPEED_10MB"` `"SPEED_100MB"` `"SPEED_1GB"` `"SPEED_2500MB"` `"SPEED_5GB"` `"SPEED_10GB"` `"SPEED_20GB"` `"SPEED_25GB"` `"SPEED_40GB"` `"SPEED_50GB"` `"SPEED_100GB"` `"SPEED_200GB"` `"SPEED_400GB"`
state string	Состояние конфигурации после выполнения модуля. Варианты: `"merged"` ← (по умолчанию) `"replaced"` `"overridden"` `"deleted"`

Примечания

Примечание

Поддерживает check_mode.

Примеры

#
# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show port-group
# -------------------------------------------------------------------------------------
# Port-group  Interface range            Valid speeds      Default Speed Current Speed
# -------------------------------------------------------------------------------------
# 1           Ethernet0 - Ethernet3      10G, 25G          25G           10G
# 2           Ethernet4 - Ethernet7      10G, 25G          25G           25G
# 3           Ethernet8 - Ethernet11     10G, 25G          25G           25G
# 4           Ethernet12 - Ethernet15    10G, 25G          25G           25G
# 5           Ethernet16 - Ethernet19    10G, 25G          25G           25G
# 6           Ethernet20 - Ethernet23    10G, 25G          25G           25G
# 7           Ethernet24 - Ethernet27    10G, 25G          25G           25G
# 8           Ethernet28 - Ethernet31    10G, 25G          25G           25G
# 9           Ethernet32 - Ethernet35    10G, 25G          25G           10G
# 10          Ethernet36 - Ethernet39    10G, 25G          25G           25G
#
- name: Configure port group speed
  sonic_port_group:
    config:
      - id: 1
      - id: 10
    state: deleted
#
#
# After state:
# ------------
#
# sonic# show port-group
# -------------------------------------------------------------------------------------
# Port-group  Interface range            Valid speeds      Default Speed Current Speed
# -------------------------------------------------------------------------------------
# 1           Ethernet0 - Ethernet3      10G, 25G          25G           25G
# 2           Ethernet4 - Ethernet7      10G, 25G          25G           25G
# 3           Ethernet8 - Ethernet11     10G, 25G          25G           25G
# 4           Ethernet12 - Ethernet15    10G, 25G          25G           25G
# 5           Ethernet16 - Ethernet19    10G, 25G          25G           25G
# 6           Ethernet20 - Ethernet23    10G, 25G          25G           25G
# 7           Ethernet24 - Ethernet27    10G, 25G          25G           25G
# 8           Ethernet28 - Ethernet31    10G, 25G          25G           25G
# 9           Ethernet32 - Ethernet35    10G, 25G          25G           10G
# 10          Ethernet36 - Ethernet39    10G, 25G          25G           25G
#
# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show port-group
# -------------------------------------------------------------------------------------
# Port-group  Interface range            Valid speeds      Default Speed Current Speed
# -------------------------------------------------------------------------------------
# 1           Ethernet0 - Ethernet3      10G, 25G          25G           10G
# 2           Ethernet4 - Ethernet7      10G, 25G          25G           25G
# 3           Ethernet8 - Ethernet11     10G, 25G          25G           25G
# 4           Ethernet12 - Ethernet15    10G, 25G          25G           25G
# 5           Ethernet16 - Ethernet19    10G, 25G          25G           25G
# 6           Ethernet20 - Ethernet23    10G, 25G          25G           25G
# 7           Ethernet24 - Ethernet27    10G, 25G          25G           25G
# 8           Ethernet28 - Ethernet31    10G, 25G          25G           25G
# 9           Ethernet32 - Ethernet35    10G, 25G          25G           10G
# 10          Ethernet36 - Ethernet39    10G, 25G          25G           25G
#
- name: Configure port group speed
  sonic_port_group:
    config:
      - id:
    state: deleted
#
#
# After state:
# ------------
#
# sonic# show port-group
# -------------------------------------------------------------------------------------
# Port-group  Interface range            Valid speeds      Default Speed Current Speed
# -------------------------------------------------------------------------------------
# 1           Ethernet0 - Ethernet3      10G, 25G          25G           25G
# 2           Ethernet4 - Ethernet7      10G, 25G          25G           25G
# 3           Ethernet8 - Ethernet11     10G, 25G          25G           25G
# 4           Ethernet12 - Ethernet15    10G, 25G          25G           25G
# 5           Ethernet16 - Ethernet19    10G, 25G          25G           25G
# 6           Ethernet20 - Ethernet23    10G, 25G          25G           25G
# 7           Ethernet24 - Ethernet27    10G, 25G          25G           25G
# 8           Ethernet28 - Ethernet31    10G, 25G          25G           25G
# 9           Ethernet32 - Ethernet35    10G, 25G          25G           25G
# 10          Ethernet36 - Ethernet39    10G, 25G          25G           25G
#
# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show port-group
# -------------------------------------------------------------------------------------
# Port-group  Interface range            Valid speeds      Default Speed Current Speed
# -------------------------------------------------------------------------------------
# 1           Ethernet0 - Ethernet3      10G, 25G          25G           25G
# 2           Ethernet4 - Ethernet7      10G, 25G          25G           25G
# 3           Ethernet8 - Ethernet11     10G, 25G          25G           25G
# 4           Ethernet12 - Ethernet15    10G, 25G          25G           25G
# 5           Ethernet16 - Ethernet19    10G, 25G          25G           25G
# 6           Ethernet20 - Ethernet23    10G, 25G          25G           25G
# 7           Ethernet24 - Ethernet27    10G, 25G          25G           25G
# 8           Ethernet28 - Ethernet31    10G, 25G          25G           25G
# 9           Ethernet32 - Ethernet35    10G, 25G          25G           25G
# 10          Ethernet36 - Ethernet39    10G, 25G          25G           25G
#
- name: Configure port group speed
  sonic_port_group:
    config:
      - id: 1
        speed: SPEED_10GB
      - id: 9
        speed: SPEED_10GB
    state: merged
#
#
# After state:
# ------------
#
# sonic# show port-group
# -------------------------------------------------------------------------------------
# Port-group  Interface range            Valid speeds      Default Speed Current Speed
# -------------------------------------------------------------------------------------
# 1           Ethernet0 - Ethernet3      10G, 25G          25G           10G
# 2           Ethernet4 - Ethernet7      10G, 25G          25G           25G
# 3           Ethernet8 - Ethernet11     10G, 25G          25G           25G
# 4           Ethernet12 - Ethernet15    10G, 25G          25G           25G
# 5           Ethernet16 - Ethernet19    10G, 25G          25G           25G
# 6           Ethernet20 - Ethernet23    10G, 25G          25G           25G
# 7           Ethernet24 - Ethernet27    10G, 25G          25G           25G
# 8           Ethernet28 - Ethernet31    10G, 25G          25G           25G
# 9           Ethernet32 - Ethernet35    10G, 25G          25G           10G
# 10          Ethernet36 - Ethernet39    10G, 25G          25G           25G
#
# Using "replaced" state
#
# Before state:
# -------------
#
# sonic# show port-group
# -------------------------------------------------------------------------------------
# Port-group  Interface range            Valid speeds      Default Speed Current Speed
# -------------------------------------------------------------------------------------
# 1           Ethernet0 - Ethernet3      10G, 25G          25G           25G
# 2           Ethernet4 - Ethernet7      10G, 25G          25G           25G
# 3           Ethernet8 - Ethernet11     10G, 25G          25G           25G
# 4           Ethernet12 - Ethernet15    10G, 25G          25G           10G
# 5           Ethernet16 - Ethernet19    10G, 25G          25G           25G
# 6           Ethernet20 - Ethernet23    10G, 25G          25G           25G
# 7           Ethernet24 - Ethernet27    10G, 25G          25G           25G
# 8           Ethernet28 - Ethernet31    10G, 25G          25G           25G
# 9           Ethernet32 - Ethernet35    10G, 25G          25G           25G
# 10          Ethernet36 - Ethernet39    10G, 25G          25G           25G
#
- name: Replace port group speed
  sonic_port_group:
    config:
      - id: 1
        speed: SPEED_10GB
      - id: 9
        speed: SPEED_10GB
    state: replaced
#
# After state:
# ------------
#
# sonic# show port-group
# -------------------------------------------------------------------------------------
# Port-group  Interface range            Valid speeds      Default Speed Current Speed
# -------------------------------------------------------------------------------------
# 1           Ethernet0 - Ethernet3      10G, 25G          25G           10G
# 2           Ethernet4 - Ethernet7      10G, 25G          25G           25G
# 3           Ethernet8 - Ethernet11     10G, 25G          25G           25G
# 4           Ethernet12 - Ethernet15    10G, 25G          25G           10G
# 5           Ethernet16 - Ethernet19    10G, 25G          25G           25G
# 6           Ethernet20 - Ethernet23    10G, 25G          25G           25G
# 7           Ethernet24 - Ethernet27    10G, 25G          25G           25G
# 8           Ethernet28 - Ethernet31    10G, 25G          25G           25G
# 9           Ethernet32 - Ethernet35    10G, 25G          25G           10G
# 10          Ethernet36 - Ethernet39    10G, 25G          25G           25G
#
# Using "overridden" state
#
# Before state:
# -------------
#
# sonic# show port-group
# -------------------------------------------------------------------------------------
# Port-group  Interface range            Valid speeds      Default Speed Current Speed
# -------------------------------------------------------------------------------------
# 1           Ethernet0 - Ethernet3      10G, 25G          25G           25G
# 2           Ethernet4 - Ethernet7      10G, 25G          25G           10G
# 3           Ethernet8 - Ethernet11     10G, 25G          25G           10G
# 4           Ethernet12 - Ethernet15    10G, 25G          25G           25G
# 5           Ethernet16 - Ethernet19    10G, 25G          25G           10G
# 6           Ethernet20 - Ethernet23    10G, 25G          25G           25G
# 7           Ethernet24 - Ethernet27    10G, 25G          25G           10G
# 8           Ethernet28 - Ethernet31    10G, 25G          25G           10G
# 9           Ethernet32 - Ethernet35    10G, 25G          25G           10G
# 10          Ethernet36 - Ethernet39    10G, 25G          25G           10G
#
- name: Override port group speed
  sonic_port_group:
    config:
      - id: 1
        speed: SPEED_10GB
      - id: 9
        speed: SPEED_10GB
    state: overridden
#
# After state:
# ------------
#
# sonic# show port-group
# -------------------------------------------------------------------------------------
# Port-group  Interface range            Valid speeds      Default Speed Current Speed
# -------------------------------------------------------------------------------------
# 1           Ethernet0 - Ethernet3      10G, 25G          25G           10G
# 2           Ethernet4 - Ethernet7      10G, 25G          25G           25G
# 3           Ethernet8 - Ethernet11     10G, 25G          25G           25G
# 4           Ethernet12 - Ethernet15    10G, 25G          25G           25G
# 5           Ethernet16 - Ethernet19    10G, 25G          25G           25G
# 6           Ethernet20 - Ethernet23    10G, 25G          25G           25G
# 7           Ethernet24 - Ethernet27    10G, 25G          25G           25G
# 8           Ethernet28 - Ethernet31    10G, 25G          25G           25G
# 9           Ethernet32 - Ethernet35    10G, 25G          25G           10G
# 10          Ethernet36 - Ethernet39    10G, 25G          25G           25G
#

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

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

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

Авторы

1. Zhang (@mingjunzhang2019)

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

© 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_port_group_module.html