Модуль cisco.nxos.nxos_pim_interface – Управление конфигурацией интерфейса PIM.

Примечание

Этот модуль входит в коллекцию cisco.nxos (версия 11.2.0).

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

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

Чтобы использовать коллекцию в плейбуке, укажите: cisco.nxos.nxos_pim_interface.

Добавлено в cisco.nxos 1.0.0

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

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

Управление параметрами конфигурации интерфейса PIM.

Примечание

Этому модулю соответствует плагин действий.

Псевдонимы: pim_interface

Параметры

Параметр	Комментарии
bfd string	Включает BFD для PIM на уровне интерфейса. Этот параметр переопределяет значение переменной bfd, заданное на глобальном уровне PIM. Допустимые значения: ‘enable’, ‘disable’ или ‘default’. Зависимость: ‘’feature bfd’’ Варианты: `"enable"` `"disable"` `"default"`
border boolean	Настраивает интерфейс как границу домена PIM. Варианты: `false` ← (по умолчанию) `true`
dr_prio string	Настраивает приоритет интерфейса при выборах DR в PIM.
hello_auth_key string	Аутентификация сообщений hello на этом интерфейсе.
hello_interval integer	Интервал отправки сообщений hello для этого интерфейса в миллисекундах или секундах. Используйте параметр hello_interval_ms, чтобы указать, задано ли значение в миллисекундах или секундах. По умолчанию используется значение в секундах.
hello_interval_ms boolean добавлено в cisco.nxos 2.0.0	Указывает, что значение hello_interval задано в миллисекундах. Если задано значение True, это означает, что пользователь указывает hello_interval в миллисекундах, поэтому преобразование не требуется. Варианты: `false` `true`
interface string / обязательный	Полное имя интерфейса, например Ethernet1/33.
jp_policy_in string	Политика для входящих сообщений join-prune.
jp_policy_out string	Политика для исходящих сообщений join-prune.
jp_type_in string	Тип политики, сопоставленный с `jp_policy_in`. Варианты: `"prefix"` `"routemap"`
jp_type_out string	Тип политики, сопоставленный с `jp_policy_out`. Варианты: `"prefix"` `"routemap"`
neighbor_policy string	Настраивает политику соседей для фильтрации смежностей.
neighbor_type string	Тип политики, сопоставленный с neighbor_policy. Варианты: `"prefix"` `"routemap"`
sparse boolean	Включает или отключает режим sparse на интерфейсе. Варианты: `false` ← (по умолчанию) `true`
state string	Управляет требуемым состоянием ресурса. Варианты: `"present"` ← (по умолчанию) `"absent"` `"default"`

Примечания

Примечание

Протестировано на NXOSv 7.3.(0)D1(1) в VIRL
Не поддерживается для Cisco MDS
При state=default поддерживаемые параметры будут сброшены в состояние по умолчанию. К ним относятся dr_prio, hello_auth_key, hello_interval, jp_policy_out, jp_policy_in, jp_type_in, jp_type_out, border, neighbor_policy, neighbor_type.
Параметр hello_auth_key не является идемпотентным.
hello_auth_key поддерживает только пароли в открытом виде.
При state=absent конфигурация интерфейса PIM будет сброшена до значений по умолчанию, а pim-sm на интерфейсе будет отключен.
Для использования этого модуля на устройстве должен быть включен PIM.
Этот модуль предназначен для интерфейсов уровня 3.
Сведения об использовании CLI и NX-API см. в :ref:`руководстве по параметрам платформы NXOS <nxos_platform_options>`
Дополнительные сведения об использовании Ansible для управления сетевыми устройствами см. в :ref:`руководстве по сетям Ansible <network_guide>`
Дополнительные сведения об использовании Ansible для управления устройствами Cisco см. на `странице интеграции Cisco <https://www.ansible.com/integrations/networks/cisco>`_.

Примеры

- name: Ensure PIM is not running on the interface
  cisco.nxos.nxos_pim_interface:
    interface: eth1/33
    state: absent

- name: Ensure the interface has pim-sm enabled with the appropriate priority and
    hello interval
  cisco.nxos.nxos_pim_interface:
    interface: eth1/33
    dr_prio: 10
    hello_interval: 40
    state: present

- name: Ensure join-prune policies exist
  cisco.nxos.nxos_pim_interface:
    interface: eth1/33
    jp_policy_in: JPIN
    jp_policy_out: JPOUT
    jp_type_in: routemap
    jp_type_out: routemap

- name: disable bfd on the interface
  cisco.nxos.nxos_pim_interface:
    interface: eth1/33
    bfd: disable

- name: Ensure defaults are in place
  cisco.nxos.nxos_pim_interface:
    interface: eth1/33
    state: default

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

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

Ключ	Описание
commands list / elements=string	команда, отправленная устройству Возвращается: всегда Пример: `["interface eth1/33", "ip pim neighbor-policy test", "ip pim bfd-instance disable", "ip pim neighbor-policy test"]`

Авторы

Jason Edelman (@jedelman8)

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

© 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/nxos/nxos_pim_interface_module.html