Spec-Zone.ru › Ansible

Модуль dellemc.enterprise_sonic.sonic_prefix_lists — управление конфигурацией списков префиксов для 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_prefix_lists.

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

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

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

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

Параметры

Параметр

Комментарии

config

list / elements=dictionary

Задает список словарей конфигурации наборов префиксов

afi

string

Задает семейство адресов для адресов в записях списка префиксов

Варианты:

  • "ipv4" ← (по умолчанию)
  • "ipv6"

name

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

Имя набора префиксов (списка записей префиксов)

prefixes

list / elements=dictionary

Список записей префиксов

action

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

Действие для адресов, соответствующих этой записи префикса

Варианты:

  • "permit"
  • "deny"

ge

integer

Минимальная длина префикса для сопоставления

le

integer

Максимальная длина префикса для сопоставления

prefix

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

Префикс IPv4 или IPv6 в формате A.B.C.D/LEN или A:B::C:D/LEN

sequence

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

Приоритет этой записи префикса (уникальный в пределах списка префиксов)

state

string

Задает тип обновления конфигурации, которое будет выполнено на устройстве.

Для «merged» объединить указанные атрибуты с уже настроенными атрибутами.

Для «deleted» удалить указанные атрибуты из существующей конфигурации.

Для «replaced» заменить указанную существующую конфигурацию предоставленной конфигурацией.

Для «overridden» переопределить существующую конфигурацию предоставленной конфигурацией.

Варианты:

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

Примечания

Примечание

  • Поддерживает check_mode.
  • Поддерживает D(diff_mode).

Примеры

# Using "merged" state to create initial configuration
#
# Before state:
# -------------
#
# sonic# show running-configuration ip prefix-list
# sonic#
# (No configuration present)
#
# -------------
#
- name: Merge initial prefix-list configuration
  dellemc.enterprise_sonic.sonic_prefix_lists:
    config:
      - name: pfx1
        afi: "ipv4"
        prefixes:
          - sequence: 10
            prefix: "1.2.3.4/24"
            action: "permit"
            ge: 26
            le: 30
    state: merged

# After state:
# ------------
#
# sonic# show running-configuration ip prefix-list
# !
# ip prefix-list pfx1 seq 10 permit 1.2.3.4/24 ge 26 le 30
# ------------
#
# ***************************************************************
# Using "merged" state to update and add configuration
#
# Before state:
# ------------
#
# sonic# show running-configuration ip prefix-list
# !
# ip prefix-list pfx1 seq 10 permit 1.2.3.4/24 ge 26 le 30
#
# sonic# show running-configuration ipv6 prefix-list
# sonic#
# (no IPv6 prefix-list configuration present)
#
# ------------
#
- name: Merge additional prefix-list configuration
  dellemc.enterprise_sonic.sonic_prefix_lists:
    config:
      - name: pfx1
        afi: "ipv4"
        prefixes:
          - sequence: 20
            action: "deny"
            prefix: "1.2.3.12/26"
          - sequence: 30
            action: "permit"
            prefix: "7.8.9.0/24"
      - name: pfx6
        afi: "ipv6"
        prefixes:
          - sequence: 25
            action: "permit"
            prefix: "40::300/124"
    state: merged

# After state:
# ------------
#
# sonic# show running-configuration ip prefix-list
# !
# ip prefix-list pfx1 seq 10 permit 1.2.3.4/24 ge 26 le 30
# ip prefix-list pfx1 seq 20 deny 1.2.3.12/26
# ip prefix-list pfx1 seq 30 permit 7.8.9.0/24
#
# sonic# show running-configuration ipv6 prefix-list
# !
# ipv6 prefix-list pfx6 seq 25 permit 40::300/124
#
# ***************************************************************
# Using "deleted" state to remove configuration
#
# Before state:
# ------------
#
# sonic# show running-configuration ip prefix-list
# !
# ip prefix-list pfx1 seq 10 permit 1.2.3.4/24 ge 26 le 30
# ip prefix-list pfx1 seq 20 deny 1.2.3.12/26
# ip prefix-list pfx1 seq 30 permit 7.8.9.0/24
#
# sonic# show running-configuration ipv6 prefix-list
# !
# ipv6 prefix-list pfx6 seq 25 permit 40::300/124
#
# ------------
#
- name: Delete selected prefix-list configuration
  dellemc.enterprise_sonic.sonic_prefix_lists:
    config:
      - name: pfx1
        afi: "ipv4"
        prefixes:
          - sequence: 10
            prefix: "1.2.3.4/24"
            action: "permit"
            ge: 26
            le: 30
          - sequence: 20
            action: "deny"
            prefix: "1.2.3.12/26"
      - name: pfx6
        afi: "ipv6"
        prefixes:
          - sequence: 25
            action: "permit"
            prefix: "40::300/124"
    state: deleted

# After state:
# ------------
#
# sonic# show running-configuration ip prefix-list
# !
# ip prefix-list pfx1 seq 30 permit 7.8.9.0/24
#
# sonic# show running-configuration ipv6 prefix-list
# sonic#
# (no IPv6 prefix-list configuration present)
#
# ***************************************************************
# Using "overriden" state to override configuration
#
# Before state:
# ------------
#
# sonic# show running-configuration ip prefix-list
# !
# ip prefix-list pfx1 seq 10 permit 1.2.3.4/24 ge 26 le 30
# ip prefix-list pfx3 seq 20 deny 1.2.3.12/26
# ip prefix-list pfx4 seq 30 permit 7.8.9.0/24
#
# sonic# show running-configuration ipv6 prefix-list
# !
# ipv6 prefix-list pfx6 seq 25 permit 40::300/124
#
# ------------
#
- name: Override prefix-list configuration
  dellemc.enterprise_sonic.sonic_prefix_lists:
    config:
      - name: pfx2
        afi: "ipv4"
        prefixes:
          - sequence: 10
            prefix: "10.20.30.128/24"
            action: "deny"
            ge: 25
            le: 30
    state: overridden

# After state:
# ------------
#
# sonic# show running-configuration ip prefix-list
# !
# ip prefix-list pfx2 seq 10 deny 10.20.30.128/24 ge 25 le 30
#
# sonic# show running-configuration ipv6 prefix-list
# sonic#
# (no IPv6 prefix-list configuration present)
#
# ***************************************************************
# Using "replaced" state to replace configuration
#
# Before state:
# ------------
#
# sonic# show running-configuration ip prefix-list
# !
# ip prefix-list pfx2 seq 10 deny 10.20.30.128/24 ge 25 le 30
#
# sonic# show running-configuration ipv6 prefix-list
# sonic#
# (no IPv6 prefix-list configuration present)
#
# ------------
#
- name: Replace prefix-list configuration
  dellemc.enterprise_sonic.sonic_prefix_lists:
    config:
      - name: pfx2
        afi: "ipv4"
        prefixes:
          - sequence: 10
            prefix: "10.20.30.128/24"
            action: "permit"
            ge: 25
            le: 30
      - name: pfx3
        afi: "ipv6"
        prefixes:
          - sequence: 20
            action: "deny"
            prefix: "60::70/124"
    state: replaced

# After state:
# ------------
#
# sonic# show running-configuration ip prefix-list
# !
# ip prefix-list pfx2 seq 10 permit 10.20.30.128/24 ge 25 le 30
#
# sonic# show running-configuration ipv6 prefix-list
# sonic#
# !
# ipv6 prefix-list pfx3 seq 20 deny 60::70/124
#

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

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

Ключ

Описание

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

diff

list / elements=string

Различия между «before» и «after» (или «after(generated)»).

Возвращается: при D(diff_mode)

Пример: ["The difference shows several lines of context around the lines that differ.\n"]

Авторы

  • Kerry Meyer (@kerry-meyer)

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

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

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

Spec-Zone.ru

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