Spec-Zone.ru › Ansible

Модуль dellemc.enterprise_sonic.sonic_acl_interfaces — управление привязкой списков контроля доступа (ACL) к интерфейсам в 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_acl_interfaces.

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

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

Обзор

  • Этот модуль управляет применением списков контроля доступа (ACL) к интерфейсам устройств под управлением SONiC.
  • ACL необходимо предварительно создать на устройстве.

Параметры

Параметр

Описание

config

list / elements=dictionary

Задает конфигурацию групп доступа интерфейса.

access_groups

list / elements=dictionary

Конфигурация групп доступа, задаваемая для интерфейса.

acls

list / elements=dictionary

Список ACL для заданного типа.

direction

string / обязательный

Задает направление передачи пакетов, к которым будет применяться ACL.

Варианты:

  • "in"
  • "out"

name

string / обязательный

Имя ACL, применяемого к интерфейсу.

type

string / обязательный

Тип ACL, применяемых к интерфейсу.

Варианты:

  • "mac"
  • "ipv4"
  • "ipv6"

name

string / обязательный

Полное имя интерфейса, например Eth1/1.

state

string

Состояние конфигурации после выполнения модуля.

merged — объединяет переданную конфигурацию групп доступа интерфейса с конфигурацией на устройстве.

replaced — заменяет конфигурацию групп доступа указанных интерфейсов на устройстве переданной конфигурацией.

overridden — заменяет все конфигурации групп доступа интерфейсов на устройстве переданной конфигурацией.

deleted — удаляет конфигурацию групп доступа интерфейсов на устройстве.

Варианты:

  • "merged" ← (значение по умолчанию)
  • "replaced"
  • "overridden"
  • "deleted"

Примечания

Примечание

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

Примеры

# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show mac access-group
# sonic#
# sonic# show ip access-group
# sonic#
# sonic# show ipv6 access-group
# Ingress IPV6 access-list ipv6-acl-1 on Eth1/1
# sonic#

- name: Merge provided interface access-group configurations
  dellemc.enterprise_sonic.sonic_acl_interfaces:
    config:
      - name: 'Eth1/1'
        access_groups:
          - type: 'mac'
            acls:
              - name: 'mac-acl-1'
                direction: 'in'
              - name: 'mac-acl-2'
                direction: 'out'
          - type: 'ipv6'
            acls:
              - name: 'ipv6-acl-2'
                direction: 'out'
      - name: 'Eth1/2'
        access_groups:
          - type: 'ipv4'
            acls:
              - name: 'ip-acl-1'
                direction: 'in'
    state: merged

# After state:
# ------------
#
# sonic# show mac access-group
# Ingress MAC access-list mac-acl-1 on Eth1/1
# Egress MAC access-list mac-acl-2 on Eth1/1
# sonic#
# sonic# show ip access-group
# Ingress IP access-list ip-acl-1 on Eth1/2
# sonic#
# sonic# show ipv6 access-group
# Ingress IPV6 access-list ipv6-acl-1 on Eth1/1
# Egress IPV6 access-list ipv6-acl-2 on Eth1/1
# sonic#


# Using "replaced" state
#
# Before state:
# -------------
#
# sonic# show mac access-group
# Ingress MAC access-list mac-acl-1 on Eth1/1
# Egress MAC access-list mac-acl-2 on Eth1/1
# sonic#
# sonic# show ip access-group
# Ingress IP access-list ip-acl-1 on Eth1/2
# sonic#
# sonic# show ipv6 access-group
# Ingress IPV6 access-list ipv6-acl-1 on Eth1/1
# Egress IPV6 access-list ipv6-acl-2 on Eth1/1
# sonic#

- name: Replace device access-group configuration of specified interfaces with provided configuration
  dellemc.enterprise_sonic.sonic_acl_interfaces:
    config:
      - name: 'Eth1/2'
        access_groups:
          - type: 'ipv6'
            acls:
              - name: 'ipv6-acl-2'
                direction: 'out'
      - name: 'Eth1/3'
        access_groups:
          - type: 'ipv4'
            acls:
              - name: 'ip-acl-2'
                direction: 'out'
    state: replaced

# After state:
# ------------
#
# sonic# show mac access-group
# Ingress MAC access-list mac-acl-1 on Eth1/1
# Egress MAC access-list mac-acl-2 on Eth1/1
# sonic#
# sonic# show ip access-group
# Egress IP access-list ip-acl-2 on Eth1/3
# sonic#
# sonic# show ipv6 access-group
# Ingress IPV6 access-list ipv6-acl-1 on Eth1/1
# Egress IPV6 access-list ipv6-acl-2 on Eth1/1
# Egress IPV6 access-list ipv6-acl-2 on Eth1/2
# sonic#


# Using "overridden" state
#
# Before state:
# -------------
#
# sonic# show mac access-group
# Ingress MAC access-list mac-acl-1 on Eth1/1
# Egress MAC access-list mac-acl-2 on Eth1/1
# sonic#
# sonic# show ip access-group
# Egress IP access-list ip-acl-2 on Eth1/3
# sonic#
# sonic# show ipv6 access-group
# Ingress IPV6 access-list ipv6-acl-1 on Eth1/1
# Egress IPV6 access-list ipv6-acl-2 on Eth1/1
# Egress IPV6 access-list ipv6-acl-2 on Eth1/2
# sonic#

- name: Override all interfaces access-group device configuration with provided configuration
  dellemc.enterprise_sonic.sonic_acl_interfaces:
    config:
      - name: 'Eth1/1'
        access_groups:
          - type: 'ip'
            acls:
              - name: 'ip-acl-2'
                direction: 'out'
      - name: 'Eth1/2'
        access_groups:
          - type: 'ip'
            acls:
              - name: 'ip-acl-2'
                direction: 'out'
    state: overridden

# After state:
# ------------
#
# sonic# show mac access-group
# sonic#
# sonic# show ip access-group
# Egress IP access-list ip-acl-2 on Eth1/1
# Egress IP access-list ip-acl-2 on Eth1/2
# sonic#
# sonic# show ipv6 access-group
# sonic#


# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show mac access-group
# Ingress MAC access-list mac-acl-1 on Eth1/1
# Egress MAC access-list mac-acl-2 on Eth1/1
# sonic#
# sonic# show ip access-group
# Egress IP access-list ip-acl-2 on Eth1/3
# sonic#
# sonic# show ipv6 access-group
# Ingress IPV6 access-list ipv6-acl-1 on Eth1/1
# Egress IPV6 access-list ipv6-acl-2 on Eth1/1
# Egress IPV6 access-list ipv6-acl-2 on Eth1/2
# sonic#

- name: Delete specified interfaces access-group configurations
  dellemc.enterprise_sonic.sonic_l2_acls:
    config:
      - name: 'Eth1/1'
        access_groups:
          - type: 'mac'
            acls:
              - name: 'mac-acl-1'
                direction: 'in'
          - type: 'ipv6'
      - name: 'Eth1/2'
    state: deleted

# After state:
# ------------
#
# sonic# show mac access-group
# Egress MAC access-list mac-acl-2 on Eth1/1
# sonic#
# sonic# show ip access-group
# Egress IP access-list ip-acl-2 on Eth1/3
# sonic#
# sonic# show ipv6 access-group
# sonic#


# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show mac access-group
# Ingress MAC access-list mac-acl-1 on Eth1/1
# Egress MAC access-list mac-acl-2 on Eth1/1
# sonic#
# sonic# show ip access-group
# Egress IP access-list ip-acl-2 on Eth1/3
# sonic#
# sonic# show ipv6 access-group
# Ingress IPV6 access-list ipv6-acl-1 on Eth1/1
# Egress IPV6 access-list ipv6-acl-2 on Eth1/1
# Egress IPV6 access-list ipv6-acl-2 on Eth1/2
# sonic#

- name: Delete all interface access-group configurations
  dellemc.enterprise_sonic.sonic_acl_interfaces:
    config:
    state: deleted

# After state:
# ------------
#
# sonic# show mac access-group
# sonic#
# sonic# show ip access-group
# sonic#
# sonic# show ipv6 access-group
# sonic#

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

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

Ключ

Описание

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"]

Авторы

  • Arun Saravanan Balachandran (@ArunSaravananBalachandran)

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

  • Отслеживание проблем
  • Репозиторий (исходный код)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API