Модуль cisco.iosxr.iosxr_prefix_lists — модуль ресурсов для настройки списков префиксов.
Примечание
Этот модуль входит в коллекцию cisco.iosxr (версия 12.3.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.iosxr.
Чтобы использовать модуль в плейбуке, укажите: cisco.iosxr.iosxr_prefix_lists.
Добавлено в cisco.iosxr 2.3.0
Краткое описание
- Этот модуль управляет конфигурацией списков префиксов на устройствах под управлением Cisco IOSXR.
Примечание
Для этого модуля имеется соответствующий плагин действий.
Псевдонимы: prefix_lists
Параметры
Параметр | Комментарии |
|---|---|
config список / элементы=словарь | Список конфигураций списков префиксов. |
|
afi строка |
Идентификатор семейства адресов (AFI) для списков префиксов. Варианты:
|
|
prefix_lists список / элементы=словарь |
Список конфигураций списков префиксов. |
|
entries список / элементы=словарь |
Список конфигураций для указанного списка префиксов |
|
action строка |
Разрешить или запретить префикс в списке префиксов. Варианты:
|
|
description строка |
Описание списка префиксов. Применяется только для действия «remark». |
|
eq целое число |
Точная длина префикса для сопоставления. |
|
ge целое число |
Минимальная длина префикса для сопоставления. |
|
le целое число |
Максимальная длина префикса для сопоставления. |
|
prefix строка |
Префикс IP или IPv6 в формате A.B.C.D/LEN или A:B::C:D/LEN. Применяется только для действий «permit» и «deny». |
|
sequence целое число |
Порядковый номер. |
|
name строка |
Имя списка префиксов. |
running_config строка | Этот параметр используется только при состоянии parsed. Значением этого параметра должен быть вывод, полученный с устройства Iosxr при выполнении команды show running-config prefix-list. Состояние parsed считывает конфигурацию из параметра |
state строка | Состояние, в котором должна остаться конфигурация. Дополнительные сведения см. в примерах. При состоянии replaced для перечисленных списков префиксов отменяются последовательности, присутствующие в running-config, но отсутствующие в задаче. При состоянии overridden отменяются все списки префиксов, присутствующие в running-config, но отсутствующие в задаче. Дополнительные сведения см. в примерах. Варианты:
|
Примечания
Примечание
- Проверено на IOSXR 7.0.2.
- Этот модуль работает с подключением
network_cli.
Примеры
# Using merged
# Before state
# RP/0/0/CPU0:10#show running-config
# Thu Feb 4 09:38:36.245 UTC
# % No such configuration item(s)
# RP/0/0/CPU0:10#
#
- name: Merge the provided configuration with the existing running configuration
cisco.iosxr.iosxr_prefix_lists:
state: merged
config:
- afi: ipv6
prefix_lists:
- name: pl_1
entries:
- prefix: '2001:db8:1234::/48'
action: deny
sequence: 1
- name: pl_2
entries:
- sequence: 2
action: remark
description: TEST_PL_2_REMARK
- afi: ipv4
prefix_lists:
- name: pl1
entries:
- sequence: 3
action: remark
description: TEST_PL1_2_REMARK
- sequence: 4
action: permit
prefix: 10.0.0.0/24
- name: pl2
entries:
- sequence: 5
action: remark
description: TEST_PL2_REMARK
- name: pl3
entries:
- sequence: 6
action: permit
prefix: 35.0.0.0/8
eq: 0
# Task Output
# -------------
# before: []
# commands:
# - ipv6 prefix-list pl_1 1 deny 2001:db8:1234::/48
# - ipv6 prefix-list pl_2 2 remark TEST_PL_2_REMARK
# - ipv4 prefix-list pl1 3 remark TEST_PL1_2_REMARK
# - ipv4 prefix-list pl1 4 permit 10.0.0.0/24
# - ipv4 prefix-list pl2 5 remark TEST_PL2_REMARK
# - ipv4 prefix-list pl3 6 permit 35.0.0.0/8 eq 0
# after:
# - afi: ipv6
# prefix_lists:
# - name: pl_1
# entries:
# - prefix: 2001:db8:1234::/48
# action: deny
# sequence: 1
# - name: pl_2
# entries:
# - sequence: 2
# action: remark
# description: TEST_PL_2_REMARK
# - afi: ipv4
# prefix_lists:
# - name: pl1
# entries:
# - sequence: 3
# action: remark
# description: TEST_PL1_2_REMARK
# - sequence: 4
# action: permit
# prefix: 10.0.0.0/24
# - name: pl2
# entries:
# - sequence: 5
# action: remark
# description: TEST_PL2_REMARK
# - name: pl3
# entries:
# - sequence: 6
# action: permit
# prefix: 35.0.0.0/8
# eq: 0
# After state:
# ------------
# RP/0/0/CPU0:10#show running-config
# ipv6 prefix-list pl_1
# 1 deny 2001:db8:1234::/48
# !
# ipv6 prefix-list pl_2
# 2 remark TEST_PL_2_REMAR
# !
# ipv4 prefix-list pl1
# 3 remark TEST_PL1_2_REMARK
# 4 permit 10.0.0.0/24
# !
# ipv4 prefix-list pl2
# 5 remark TEST_PL2_REMARK
# !
# ipv4 prefix-list pl3
# 6 permit 35.0.0.0/8 eq 0
# !
# Using replaced:
# Before state:
# -------------
# RP/0/0/CPU0:10#show running-config
#
# ipv6 prefix-list pl_1
# 1 deny 2001:db8:1234::/48
# !
# ipv6 prefix-list pl_2
# 2 remark TEST_PL_2_REMARK
# !
# ipv4 prefix-list pl1
# 3 remark TEST_PL1_2_REMARK
# 4 permit 10.0.0.0/24
# !
# ipv4 prefix-list pl2
# 5 remark TEST_PL2_REMARK
# !
#
- name: >-
Replace device configurations of listed prefix lists with provided
configurations
register: result
cisco.iosxr.iosxr_prefix_lists:
config:
- afi: ipv4
prefix_lists:
- name: pl1
entries:
- sequence: 3
action: permit
prefix: 10.0.0.0/24
- afi: ipv6
prefix_lists:
- name: pl_1
entries:
- prefix: '2001:db8:1234::/48'
action: permit
sequence: 1
- name: pl_2
entries:
- sequence: 2
action: remark
description: TEST_PL1_2
state: replaced
# Task Output
# -------------
# before:
# - afi: ipv6
# prefix_lists:
# - entries:
# - action: deny
# prefix: 2001:db8:1234::/48
# sequence: 1
# name: pl_1
# - entries:
# - action: remark
# description: TEST_PL_2_REMARK
# sequence: 2
# name: pl_2
# - afi: ipv4
# prefix_lists:
# - entries:
# - action: remark
# description: TEST_PL1_2_REMARK
# sequence: 3
# - action: permit
# prefix: 10.0.0.0/24
# sequence: 4
# name: pl1
# - entries:
# - action: remark
# description: TEST_PL2_REMARK
# sequence: 5
# name: pl2
# commands:
# - no ipv4 prefix-list pl1 3 remark TEST_PL1_2_REMARK
# - no ipv4 prefix-list pl1 4 permit 10.0.0.0/24
# - ipv4 prefix-list pl1 3 permit 10.0.0.0/24
# - ipv6 prefix-list pl_2 2 remark TEST_PL1_2
# after:
# - afi: ipv6
# prefix_lists:
# - entries:
# - action: deny
# prefix: 2001:db8:1234::/48
# sequence: 1
# name: pl_1
# - entries:
# - action: remark
# description: TEST_PL1_2
# sequence: 2
# name: pl_2
# - afi: ipv4
# prefix_lists:
# - entries:
# - action: permit
# prefix: 10.0.0.0/24
# sequence: 3
# name: pl1
# - entries:
# - action: remark
# description: TEST_PL2_REMARK
# sequence: 5
# name: pl2
# After state:
# RP/0/0/CPU0:10#show running-config
#
# ipv6 prefix-list pl_1
# 1 deny 2001:db8:1234::/48
# !
# ipv6 prefix-list pl_2
# 2 remark TEST_PL1_2
# !
# ipv4 prefix-list pl1
# 3 permit 10.0.0.0/24
# !
# ipv4 prefix-list pl2
# 5 remark TEST_PL2_REMARK
#
# Module Execution:
#
# Using deleted:
# Before state:
# -------------
# RP/0/0/CPU0:10#show running-config
#
# ipv6 prefix-list pl_1
# 1 deny 2001:db8:1234::/48
# !
# ipv6 prefix-list pl_2
# 2 remark TEST_PL_2_REMARK
# !
# ipv4 prefix-list pl1
# 3 remark TEST_PL1_2_REMARK
# 4 permit 10.0.0.0/24
# !
# ipv4 prefix-list pl2
# 5 remark TEST_PL2_REMARK
# ipv4 prefix-list pl3
# 6 permit 35.0.0.0/8 eq 0
- name: Delete all prefix-lists from the device
cisco.iosxr.iosxr_prefix_lists:
state: deleted
# Task Output
# -------------
# before:
# - afi: ipv6
# prefix_lists:
# - name: pl_1
# entries:
# - prefix: 2001:db8:1234::/48
# action: deny
# sequence: 1
# - name: pl_2
# entries:
# - sequence: 2
# action: remark
# description: TEST_PL_2_REMARK
# - afi: ipv4
# prefix_lists:
# - name: pl1
# entries:
# - sequence: 3
# action: remark
# description: TEST_PL1_2_REMARK
# - sequence: 4
# action: permit
# prefix: 10.0.0.0/24
# - name: pl2
# entries:
# - sequence: 5
# action: remark
# description: TEST_PL2_REMARK
# - name: pl3
# entries:
# - sequence: 6
# action: permit
# prefix: 35.0.0.0/8
# eq: 0
# commands:
# - no ipv6 prefix-list pl_1
# - no ipv6 prefix-list pl_2
# - no ipv4 prefix-list pl1
# - no ipv4 prefix-list pl2
# - no ipv4 prefix-list pl3
# after: []
# After state:
# RP/0/0/CPU0:10#show running-config
#
# using gathered:
# After state:
# ------------
# RP/0/0/CPU0:10#show running-config
# ipv6 prefix-list pl_1
# 1 deny 2001:db8:1234::/48
# !
# ipv6 prefix-list pl_2
# 2 remark TEST_PL_2_REMARK
# !
# ipv4 prefix-list pl1
# 3 remark TEST_PL1_2_REMARK
# 4 permit 10.0.0.0/24
# !
# ipv4 prefix-list pl2
# 5 remark TEST_PL2_REMARK
# !
# ipv4 prefix-list pl3
# 6 permit 35.0.0.0/8 eq 0
# !
- name: Gather ACL interfaces facts using gathered state
cisco.iosxr.iosxr_prefix_lists:
state: gathered
# gathered:
# - afi: ipv6
# prefix_lists:
# - name: pl_1
# entries:
# - prefix: 2001:db8:1234::/48
# action: deny
# sequence: 1
# - name: pl_2
# entries:
# - sequence: 2
# action: remark
# description: TEST_PL_2_REMARK
# - afi: ipv4
# prefix_lists:
# - name: pl1
# entries:
# - sequence: 3
# action: remark
# description: TEST_PL1_2_REMARK
# - sequence: 4
# action: permit
# prefix: 10.0.0.0/24
# - name: pl2
# entries:
# - sequence: 5
# action: remark
# description: TEST_PL2_REMARK
# - name: pl3
# entries:
# - sequence: 6
# action: permit
# prefix: 35.0.0.0/8
# eq: 0
# Using parsed:
# parsed.cfg
# ------------------------------
# ipv6 prefix-list pl_1
# 1 deny 2001:db8:1234::/48
# !
# ipv6 prefix-list pl_2
# 2 remark TEST_PL_2_REMARK
# !
# ipv4 prefix-list pl1
# 3 remark TEST_PL1_2_REMARK
# 4 permit 10.0.0.0/24
# !
# ipv4 prefix-list pl2
# 5 remark TEST_PL2_REMARK
- name: Parse externally provided Prefix_lists config to agnostic model
cisco.iosxr.iosxr_prefix_lists:
running_config: '{{ lookup(''file'', ''./fixtures/parsed.cfg'') }}'
state: parsed
# Task Output
# -------------
# parsed:
# - afi: ipv6
# prefix_lists:
# - name: pl_1
# entries:
# - prefix: 2001:db8:1234::/48
# action: deny
# sequence: 1
# - name: pl_2
# entries:
# - sequence: 2
# action: remark
# description: TEST_PL_2_REMARK
# - afi: ipv4
# prefix_lists:
# - name: pl1
# entries:
# - sequence: 3
# action: remark
# description: TEST_PL1_2_REMARK
# - sequence: 4
# action: permit
# prefix: 10.0.0.0/24
# - name: pl2
# entries:
# - sequence: 5
# action: remark
# description: TEST_PL2_REMARK
# - sequence: 6
# action: permit
# prefix: 35.0.0.0/8
# eq: 0
# Using rendered:
- name: Render platform specific commands from task input using rendered state
register: result
cisco.iosxr.iosxr_prefix_lists:
config:
- afi: ipv6
prefix_lists:
- name: pl_1
entries:
- prefix: '2001:db8:1234::/48'
action: deny
sequence: 1
- name: pl_2
entries:
- sequence: 2
action: remark
description: TEST_PL_2_REMARK
- afi: ipv4
prefix_lists:
- name: pl1
entries:
- sequence: 3
action: remark
description: TEST_PL1_2_REMARK
- sequence: 4
action: permit
prefix: 10.0.0.0/24
- name: pl2
entries:
- sequence: 5
action: remark
description: TEST_PL2_REMARK
- sequence: 6
action: permit
prefix: 35.0.0.0/8
eq: 0
state: rendered
# Task Output
# -------------
# "rendered": [
# "ipv6 prefix-list pl_1 1 deny 2001:db8:1234::/48",
# "ipv6 prefix-list pl_2 2 remark TEST_PL_2_REMARK",
# "ipv4 prefix-list pl1 3 remark TEST_PL1_2_REMARK",
# "ipv4 prefix-list pl1 4 permit 10.0.0.0/24",
# "ipv4 prefix-list pl2 5 remark TEST_PL2_REMARK",
# "ipv4 prefix-list pl2 6 permit 35.0.0.0/8 eq 0"
# ]
# Using overridden:
# Before state:
# -------------
# RP/0/0/CPU0:10#show running-config
#
# ipv6 prefix-list pl_1
# 1 deny 2001:db8:1234::/48
# !
# ipv6 prefix-list pl_2
# 2 remark TEST_PL_2_REMARK
# !
# ipv4 prefix-list pl1
# 3 remark TEST_PL1_2_REMARK
# 4 permit 10.0.0.0/24
# !
# ipv4 prefix-list pl2
# 5 remark TEST_PL2_REMARK
#
- name: Overridde all Prefix_lists configuration with provided configuration
cisco.iosxr.iosxr_prefix_lists:
config:
- afi: ipv4
prefix_lists:
- name: pl3
entries:
- sequence: 3
action: remark
description: TEST_PL1_3_REMARK
- sequence: 4
action: permit
prefix: 10.0.0.0/24
- sequence: 6
action: permit
prefix: 35.0.0.0/8
eq: 0
state: overridden
# Task Output
# -------------
# before:
# - afi: ipv6
# prefix_lists:
# - entries:
# - action: deny
# prefix: 2001:db8:1234::/48
# sequence: 1
# name: pl_1
# - entries:
# - action: remark
# description: TEST_PL_2_REMARK
# sequence: 2
# name: pl_2
# - afi: ipv4
# prefix_lists:
# - entries:
# - action: remark
# description: TEST_PL1_2_REMARK
# sequence: 3
# - action: permit
# prefix: 10.0.0.0/24
# sequence: 4
# name: pl1
# - entries:
# - action: remark
# description: TEST_PL2_REMARK
# sequence: 5
# name: pl2
# commands:
# - no ipv6 prefix-list pl_1
# - no ipv6 prefix-list pl_2
# - no ipv4 prefix-list pl1
# - no ipv4 prefix-list pl2
# - ipv4 prefix-list pl3 3 remark TEST_PL1_3_REMARK
# - ipv4 prefix-list pl3 4 permit 10.0.0.0/24
# - ipv4 prefix-list pl3 6 permit 35.0.0.0/8 eq 0
# after:
# - afi: ipv4
# prefix_lists:
# - entries:
# - action: remark
# description: TEST_PL1_3_REMARK
# sequence: 3
# - action: permit
# prefix: 10.0.0.0/24
# sequence: 4
# - action: permit
# prefix: 35.0.0.0/8
# sequence: 6
# eq: 0
# name: pl3
# After state:
# RP/0/0/CPU0:10#show running-config
#
# ipv4 prefix-list pl3
# 3 remark TEST_PL1_3_REMARK
# 4 permit 10.0.0.0/24
# 6 permit 35.0.0.0/8 eq 0
# !
# !
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
after словарь | Итоговая конфигурация после выполнения модуля. Возвращается: при наличии изменений Пример: |
before словарь | Конфигурация до выполнения модуля. Возвращается: когда state имеет значение Пример: |
commands список / элементы=строка | Набор команд, отправленных на удалённое устройство. Возвращается: когда state имеет значение Пример: |
gathered список / элементы=строка | Сведения о сетевом ресурсе, собранные с удалённого устройства в виде структурированных данных. Возвращается: когда state имеет значение Пример: |
parsed список / элементы=строка | Собственная конфигурация устройства, переданная в параметре running_config и разобранная в структурированные данные согласно спецификации аргументов модуля. Возвращается: когда state имеет значение Пример: |
rendered список / элементы=строка | Переданная в задаче конфигурация преобразована в собственный формат устройства (без подключения к устройству). Возвращается: когда state имеет значение Пример: |
Ссылки на коллекцию
© 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/cisco/iosxr/iosxr_prefix_lists_module.html
