Модуль cisco.nxos.nxos_igmp_interface — управляет конфигурацией интерфейса IGMP.
Примечание
Этот модуль входит в коллекцию cisco.nxos (версия 11.2.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.nxos.
Чтобы использовать коллекцию в плейбуке, укажите: cisco.nxos.nxos_igmp_interface.
Добавлено в cisco.nxos 1.0.0
Краткое описание
- Управляет параметрами конфигурации интерфейса IGMP.
Примечание
Этому модулю соответствует плагин действия.
Псевдонимы: igmp_interface
Параметры
Параметр | Описание |
|---|---|
group_timeout string | Задает время ожидания членства в группе для IGMPv2. Допустимые значения — от 3 до 65 535 секунд или ключевое слово ‘default’. Значение по умолчанию — 260 секунд. |
immediate_leave boolean | Позволяет устройству немедленно удалять запись о группе из таблицы маршрутизации многоадресной рассылки при получении сообщения о выходе из группы. Используйте эту команду, чтобы свести к минимуму задержку выхода из групп IGMPv2 на заданном интерфейсе IGMP, поскольку устройство не отправляет запросы для конкретной группы. По умолчанию отключено. Варианты:
|
interface string / обязательный | Полное имя интерфейса для настройки IGMP, например Ethernet1/2. |
last_member_qrt string | Задает интервал ожидания запросов после отправки отчетов о членстве до удаления программным обеспечением состояния группы. Допустимые значения — от 1 до 25 секунд или ключевое слово ‘default’. Значение по умолчанию — 1 секунда. |
last_member_query_count string | Задает количество запросов IGMP, отправляемых программным обеспечением в ответ на сообщение хоста о выходе из группы. Допустимые значения — от 1 до 5 или ключевое слово ‘default’. Значение по умолчанию — 2. |
oif_ps any | Настраивает префиксы и источники для статического исходящего интерфейса (OIF). Это список словарей, каждый из которых содержит источник и префикс либо только префикс, если источник не требуется. Указанные значения будут настроены на устройстве, а ранее настроенные префиксы и источники будут удалены. Также принимается ключевое слово ‘default’, которое удаляет все существующие префиксы и источники. |
oif_routemap string | Настраивает route-map для статического исходящего интерфейса (OIF) или принимает ключевое слово ‘default’. |
querier_timeout string | Задает время ожидания querier, используемое программным обеспечением при принятии решения о том, следует ли стать querier. Допустимые значения — от 1 до 65 535 секунд или ключевое слово ‘default’. Значение по умолчанию — 255 секунд. |
query_interval string | Задает частоту отправки программным обеспечением сообщений запросов узлов IGMP. Допустимые значения — от 1 до 18 000 секунд или ключевое слово ‘default’. Значение по умолчанию — 125 секунд. |
query_mrt string | Задает время ответа, объявляемое в запросах IGMP. Допустимые значения — от 1 до 25 секунд или ключевое слово ‘default’. Значение по умолчанию — 10 секунд. |
report_llg boolean | Настраивает отправку отчетов для локальных канальных групп. Включает отправку отчетов для групп в диапазоне 224.0.0.0/24. Отчеты для групп, не являющихся локальными канальными, отправляются всегда. По умолчанию отчеты для локальных канальных групп не отправляются. Варианты:
|
restart boolean | Перезапускает IGMP. Операция НЕ является идемпотентной, поскольку выполняет только действие. Варианты:
|
robustness string | Задает переменную устойчивости. Допустимые значения — от 1 до 7 или ключевое слово ‘default’. Значение по умолчанию — 2. |
startup_query_count string | Количество запросов, используемое при запуске процесса IGMP. Допустимые значения — от 1 до 10 или ключевое слово ‘default’. Значение по умолчанию — 2. |
startup_query_interval string | Интервал запросов, используемый при запуске процесса IGMP. Допустимые значения — от 1 до 18 000 или ключевое слово ‘default’. Значение по умолчанию — 31. |
state string | Управляет требуемым состоянием ресурса. Варианты:
|
version string | Версия IGMP. Допустимы значения 2, 3 или ключевое слово ‘default’. Варианты:
|
Примечания
Примечание
- Проверено на NXOSv 7.3.(0)D1(1) в VIRL
- Не поддерживается для Cisco MDS
- При
state=defaultподдерживаемые параметры будут сброшены в состояние по умолчанию. К ним относятсяversion,startup_query_interval,startup_query_count,robustness,querier_timeout,query_mrt,query_interval,last_member_qrt,last_member_query_count,group_timeout,report_llgиimmediate_leave. - При
state=absentбудут удалены все конфигурации дляoif_psиoif_routemap. - Для использования этого модуля необходимо включить PIM.
- Этот модуль предназначен для интерфейсов уровня 3.
- При настройке route-map с параметром ‘static-oif’ проверка route-map не выполняется (как и в CLI).
- Если для параметра restart задано значение true вместе с другими параметрами, перезапуск будет выполнен последним, то есть после применения конфигурации. Однако сам параметр ‘restart’ не является идемпотентным, поскольку выполняет действие, а не задает конфигурацию.
- Сведения об использовании CLI и NX-API см. в :ref:`руководстве по параметрам платформы NXOS <nxos_platform_options>`
- Дополнительные сведения об использовании Ansible для управления сетевыми устройствами см. в :ref:`руководстве по работе с сетями в Ansible <network_guide>`
- Дополнительные сведения об использовании Ansible для управления устройствами Cisco см. на `странице интеграции Cisco <https://www.ansible.com/integrations/networks/cisco>`_.
Примеры
- cisco.nxos.nxos_igmp_interface:
interface: ethernet1/32
startup_query_interval: 30
oif_ps:
- {prefix: 238.2.2.6}
- {source: 192.168.0.1, prefix: 238.2.2.5}
state: present
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
changed boolean | проверяет, были ли внесены изменения на устройстве Возвращается: всегда Пример: |
end_state dictionary | пары ключ/значение конфигурации интерфейса IGMP после выполнения модуля Возвращается: всегда Пример: |
existing dictionary | пары ключ/значение существующей конфигурации igmp_interface Возвращается: всегда Пример: |
proposed dictionary | пары ключ/значение параметров, переданных модулю Возвращается: всегда Пример: |
updates list / elements=string | команды, отправленные устройству Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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_igmp_interface_module.html