Spec-Zone.ru › Ansible

Модуль 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, поскольку устройство не отправляет запросы для конкретной группы. По умолчанию отключено.

Варианты:

  • false
  • true

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. Отчеты для групп, не являющихся локальными канальными, отправляются всегда. По умолчанию отчеты для локальных канальных групп не отправляются.

Варианты:

  • false
  • true

restart

boolean

Перезапускает IGMP. Операция НЕ является идемпотентной, поскольку выполняет только действие.

Варианты:

  • false ← (по умолчанию)
  • true

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

Управляет требуемым состоянием ресурса.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"
  • "default"

version

string

Версия IGMP. Допустимы значения 2, 3 или ключевое слово ‘default’.

Варианты:

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

проверяет, были ли внесены изменения на устройстве

Возвращается: всегда

Пример: true

end_state

dictionary

пары ключ/значение конфигурации интерфейса IGMP после выполнения модуля

Возвращается: всегда

Пример: {"oif_ps": [{"prefix": "238.2.2.6"}, {"prefix": "238.2.2.5", "source": "192.168.0.1"}], "startup_query_count": "30"}

existing

dictionary

пары ключ/значение существующей конфигурации igmp_interface

Возвращается: всегда

Пример: {"oif_ps": [], "startup_query_count": "2"}

proposed

dictionary

пары ключ/значение параметров, переданных модулю

Возвращается: всегда

Пример: {"oif_ps": [{"prefix": "238.2.2.6"}, {"prefix": "238.2.2.5", "source": "192.168.0.1"}], "startup_query_count": "30"}

updates

list / elements=string

команды, отправленные устройству

Возвращается: всегда

Пример: ["interface Ethernet1/32", "ip igmp startup-query-count 30", "ip igmp static-oif 238.2.2.6", "ip igmp static-oif 238.2.2.5 source 192.168.0.1"]

Авторы

  • Jason Edelman (@jedelman8)
  • Gabriele Gerbino (@GGabriele)

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

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

© 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

Spec-Zone.ru

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