dellemc.enterprise_sonic.sonic_copp module – Управление конфигурацией CoPP в 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_copp.

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

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

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

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

Параметры

Параметр	Комментарии
config словарь	Задаёт конфигурацию CoPP
copp_groups список / элементы=словарь	Список записей CoPP, составляющих группу CoPP
cbs строка	Размер подтверждённого буфера в пакетах или байтах
cir строка	Подтверждённая информационная скорость в бит/с или пакетах/с (пакетах в секунду)
copp_name строка / обязательный	Имя классификатора CoPP
queue целое число	Идентификатор очереди CoPP
trap_action строка	Действие перехвата CoPP Варианты: `"copy"` `"copy_cancel"` `"deny"` `"drop"` `"forward"` `"log"` `"transit"` `"trap"`
trap_priority целое число	Приоритет перехвата CoPP
copp_traps список / элементы=словарь добавлено в dellemc.enterprise_sonic 3.1.0	Список записей CoPP, составляющих перехват CoPP
name строка / обязательный	Имя перехвата CoPP
trap_group строка	Имя группы CoPP
trap_protocol_ids строка	Строка с разделёнными запятыми идентификаторами протоколов перехвата
state строка	Состояние конфигурации после выполнения модуля Варианты: `"merged"` ← (по умолчанию) `"deleted"` `"replaced"` `"overridden"`

Примечания

Примечание

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

Примеры

# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show copp actions
# (No "copp actions" configuration present)
# sonic# show copp classifiers
# (No "copp classifiers" configuration present)

- name: Merge CoPP configuration
  dellemc.enterprise_sonic.sonic_copp:
    config:
      copp_groups:
        - copp_name: 'copp-1'
          trap_priority: 1
          trap_action: 'drop'
          queue: 1
          cir: '45'
          cbs: '45'
        - copp_name: 'copp-2'
          trap_priority: 2
          trap_action: 'forward'
          queue: 2
          cir: '90'
          cbs: '90'
      copp_traps:
        - name: 'trap-1'
          trap_protocol_ids: 'id1,id2,id3'
          trap_group: 'copp-1'
    state: merged

# After state:
# ------------
#
# sonic# show copp actions
# CoPP action group copp-1
#    trap-action drop
#    trap-priority 1
#    trap-queue 1
#    police cir 45 cbs 45
# CoPP action group copp-2
#    trap-action forward
#    trap-priority 2
#    trap-queue 2
#    police cir 90 cbs 90
# sonic# show copp classifiers
# Class-map trap-1 match-type copp
#   protocol id1
#   protocol id2
#   protocol id3


# Using "replaced" state
#
# Before state:
# -------------
#
# sonic# show copp actions
# CoPP action group copp-1
#    trap-action drop
#    trap-priority 1
#    trap-queue 1
#    police cir 45 cbs 45
# CoPP action group copp-2
#    trap-action forward
#    trap-priority 2
#    trap-queue 2
#    police cir 55 cbs 55
# sonic# show copp classifiers
# Class-map trap-1 match-type copp
#   protocol id1
#   protocol id2
#   protocol id3

- name: Replace CoPP configuration
  dellemc.enterprise_sonic.sonic_copp:
    config:
      copp_groups:
        - copp_name: 'copp-1'
          trap_priority: 2
          trap_action: 'forward'
          queue: 2
        - copp_name: 'copp-3'
          trap_priority: 3
          trap_action: 'drop'
          queue: 3
          cir: '1000'
          cbs: '1000'
      copp_traps:
        - name: 'trap-1'
          trap_protocol_ids: 'id1'
          trap_group: 'copp-2'
    state: replaced

# After state:
# ------------
#
# sonic# show copp actions
# CoPP action group copp-1
#    trap-action forward
#    trap-priority 2
#    trap-queue 2
# CoPP action group copp-2
#    trap-action forward
#    trap-priority 2
#    trap-queue 2
#    police cir 55 cbs 55
# CoPP action group copp-3
#    trap-action drop
#    trap-priority 3
#    trap-queue 3
#    police cir 1000 cbs 1000
# sonic# show copp classifiers
# Class-map trap-1 match-type copp
#   protocol id1


# Using "overridden" state
#
# Before state:
# -------------
#
# sonic# show copp actions
# CoPP action group copp-1
#    trap-action forward
#    trap-priority 2
#    trap-queue 2
# CoPP action group copp-3
#    trap-action drop
#    trap-priority 3
#    trap-queue 3
#    police cir 1000 cbs 1000
# Class-map trap-1 match-type copp
#   protocol id1

- name: Override CoPP configuration
  dellemc.enterprise_sonic.sonic_copp:
    config:
      copp_groups:
        - copp_name: 'copp-4'
          trap_priority: 4
          trap_action: 'forward'
          queue: 4
          cir: 200
          cbs: 200
    state: overridden

# After state:
# ------------
#
# sonic# show copp actions
# CoPP action group copp-4
#    trap-action forward
#    trap-priority 4
#    trap-queue 4
#    police cir 200 cbs 200


# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show copp actions
# CoPP action group copp-1
#    trap-action drop
#    trap-priority 1
#    trap-queue 1
#    police cir 45 cbs 45
# CoPP action group copp-2
#    trap-action forward
#    trap-priority 2
#    trap-queue 2
#    police cir 90 cbs 90
# Class-map trap-1 match-type copp

- name: Delete CoPP configuration
  dellemc.enterprise_sonic.sonic_copp:
    config:
      copp_groups:
        - copp_name: 'copp-1'
          cir: '45'
          cbs: '45'
        - copp_name: 'copp-2'
      copp_traps:
        - name: 'trap-1'
    state: deleted

# After state:
# ------------
#
# sonic# show copp actions
# CoPP action group copp-1
#    trap-action drop
#    trap-priority 1
#    trap-queue 1

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

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

Ключ	Описание
after словарь	Конфигурация, полученная в результате вызова модуля. Возвращается: при изменении
after(generated) словарь	Конфигурация, которая была бы создана при вызове модуля вне режима проверки. Возвращается: когда `check_mode`
before словарь	Конфигурация до вызова модуля. Возвращается: всегда
commands список / элементы=строка	Набор команд, переданных на удалённое устройство. Возвращается: всегда Пример: `["command 1", "command 2", "command 3"]`

Авторы

1. Талаби (@stalabi1)

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

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