Spec-Zone.ru › Ansible

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

Примечание

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

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

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

Для использования в playbook, укажите: 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

Позволяет устройству немедленно удалить запись группы из таблицы маршрутизации multicast после получения сообщения о выходе из группы. Используйте эту команду для минимизации задержки выхода из членства в группе IGMPv2 на данном интерфейсе IGMP, поскольку устройство не отправляет запросы, относящиеся к конкретной группе. По умолчанию отключено.

Варианты:

  • false
  • true

interface

string / required

Полное имя интерфейса для конфигурации 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). Это список словарей, где каждый словарь имеет определенные source и prefix или только prefix, если source не требуется. Указанные значения будут настроены на устройстве, и если существуют какие-либо предыдущие префиксы/источники, они будут удалены. Ключевое слово ‘default’ также принимается, которое удаляет все существующие префиксы/источники.

oif_routemap

string

Настроить карту маршрутизации для статического исходящего интерфейса (OIF) или ключевое слово ‘default’.

querier_timeout

string

Устанавливает таймаут запроса, который программное обеспечение использует при принятии решения о перехвате роли запрашивающего. Значения могут варьироваться от 1 до 65535 секунд или ключевое слово ‘default’. По умолчанию используется 255 секунд.

query_interval

string

Устанавливает частоту, с которой программное обеспечение отправляет сообщения запроса узла IGMP. Значения могут варьироваться от 1 до 18000 секунд или ключевое слово ‘default’. По умолчанию используется 125 секунд.

query_mrt

string

Устанавливает время отклика, объявленное в запросах IGMP. Значения могут варьироваться от 1 до 25 секунд или ключевое слово ‘default’. По умолчанию используется 10 секунд.

report_llg

boolean

Настраивает report-link-local-groups. Включает отправку отчетов для групп в 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 до 18000 или ключевое слово ‘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.
  • Проверка маршрутной карты не выполняется (так же, как в CLI) при конфигурировании маршрутной карты с параметром ‘static-oif’
  • Если параметр перезагрузки установлен в значение true вместе с другими параметрами, перезагрузка произойдёт последней, то есть после выполнения конфигурации. Однако, сама перезагрузка не является идемпотентной, так как это действие, а не конфигурация.
  • Для получения информации по использованию CLI и NX-API см. руководство :ref:`NXOS Platform Options <nxos_platform_options>`
  • Для получения дополнительной информации об использовании Ansible для управления сетевыми устройствами см. руководство :ref:`Ansible Network Guide <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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/nxos/nxos_igmp_interface_module.html

Spec-Zone.ru

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