Модуль cisco.mso.ndo_tenant_igmp_snooping_policy — управление политиками IGMP Snooping в шаблонах политик арендаторов в Cisco Nexus Dashboard Orchestrator (NDO).

Примечание

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

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

Для установки используйте: ansible-galaxy collection install cisco.mso. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: cisco.mso.ndo_tenant_igmp_snooping_policy.

Краткое описание
Требования
Параметры
Примечания
См. также
Примеры

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

Управление политиками IGMP Snooping в шаблонах политик арендаторов в Cisco Nexus Dashboard Orchestrator (NDO).
Этот модуль поддерживается только в ND v3.1 (NDO v4.3) и более поздних версиях.

Требования

На хосте, выполняющем этот модуль, требуются следующие компоненты.

Multi Site Orchestrator версии 2.1 или новее

Параметры

Параметр	Комментарии
admin_state string	Административное состояние политики IGMP Snooping. При создании по умолчанию используется `enabled`, если значение не задано. Допустимые значения: `"enabled"` `"disabled"`
description string	Описание политики IGMP Snooping. Если указать пустую строку, из политики IGMP Snooping будет удалено `description=""`.
fast_leave_control string	Управление быстрым выходом в политике IGMP Snooping. При создании по умолчанию используется `disabled`, если значение не задано. Допустимые значения: `"enabled"` `"disabled"`
host псевдонимы: hostname string	IP-адрес или имя хоста узла ACI Multi Site Orchestrator. Если значение не задано в задаче, вместо него будет использовано значение переменной окружения `MSO_HOST`.
last_member_query_interval integer	Интервал запроса последнего участника в секундах. Интервал запроса последнего участника для политики IGMP Snooping. При создании по умолчанию используется значение 1, если параметр не задан. Значение должно быть от 1 до 25.
login_domain string	Имя домена входа, используемого для аутентификации. Значение по умолчанию — Local. Если значение не задано в задаче, вместо него будет использовано значение переменной окружения `MSO_LOGIN_DOMAIN`. При использовании подключаемого модуля соединения HTTPAPI, если этот атрибут не задан, будет использоваться переменная инвентаря `ansible_httpapi_login_domain`.
name псевдонимы: igmp_snooping_policy string	Имя политики IGMP Snooping.
output_level string	Управляет выводом этого модуля MSO. `normal` означает стандартный вывод, включая словарь `current` `info` добавляет информационный вывод, включая `previous`, `proposed` и словари `sent` `debug` добавляет отладочный вывод, включая `filter_string`, `method`, `response`, `status` и информацию `url` Если значение не задано в задаче, вместо него будет использовано значение переменной окружения `MSO_OUTPUT_LEVEL`. Допустимые значения: `"debug"` `"info"` `"normal"` ← (по умолчанию)
password string	Пароль для аутентификации. Если значение не задано в задаче, вместо него будет использовано значение переменной окружения `MSO_PASSWORD` или `ANSIBLE_NET_PASSWORD`.
port integer	Номер порта для REST-соединения. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не задано в задаче, вместо него будет использовано значение переменной окружения `MSO_PORT`.
querier_control string	Управление отправителем запросов в политике IGMP Snooping. При создании по умолчанию используется `disabled`, если значение не задано. Допустимые значения: `"enabled"` `"disabled"`
querier_version string	Версия отправителя запросов в политике IGMP Snooping. При создании по умолчанию используется `v3`, если значение не задано. Допустимые значения: `"v2"` `"v3"`
query_interval integer	Интервал запросов в секундах. Интервал запросов для политики IGMP Snooping. При создании по умолчанию используется значение 125, если параметр не задан. Значение должно быть от 1 до 18000.
query_response_interval integer	Интервал ответа на запрос в секундах. Интервал ответа на запрос для политики IGMP Snooping. При создании по умолчанию используется значение 10, если параметр не задан. Значение должно быть от 1 до 25.
start_query_count integer	Количество начальных запросов для политики IGMP Snooping. При создании по умолчанию используется значение 2, если параметр не задан. Значение должно быть от 1 до 10.
start_query_interval integer	Интервал начальных запросов в секундах. Интервал начальных запросов для политики IGMP Snooping. При создании по умолчанию используется значение 31, если параметр не задан. Значение должно быть от 1 до 18000.
state string	Используйте `absent` для удаления. Используйте `query` для получения одного или нескольких объектов. Используйте `present` для создания или обновления. Допустимые значения: `"absent"` `"query"` ← (по умолчанию) `"present"`
template псевдонимы: tenant_template string / обязательный	Имя шаблона арендатора.
timeout integer	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не задано в задаче, вместо него будет использовано значение переменной окружения `MSO_TIMEOUT`.
use_proxy boolean	Если `false`, прокси использоваться не будет, даже если он задан в переменной окружения на целевых хостах. Если значение не задано в задаче, вместо него будет использовано значение переменной окружения `MSO_USE_PROXY`. Значение по умолчанию — `true`. Допустимые значения: `false` `true`
use_ssl boolean	Если `false`, вместо HTTPS-соединения по умолчанию будет использоваться HTTP-соединение. Если значение не задано в задаче, вместо него будет использовано значение переменной окружения `MSO_USE_SSL`. При использовании подключаемого модуля соединения HTTPAPI, если этот атрибут не задан, будет использоваться переменная инвентаря `ansible_httpapi_use_ssl`. При использовании подключаемого модуля соединения HTTPAPI (mso или nd) значение по умолчанию — `false`, а при использовании устаревшего метода подключения (только для mso) — `true`. Допустимые значения: `false` `true`
username string	Имя пользователя для аутентификации. Если значение не задано в задаче, вместо него будет использовано значение переменной окружения `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
uuid string	UUID политики IGMP Snooping. Этот параметр необходим, если требуется обновить политику IGMP Snooping `name`.
validate_certs boolean	Если `false`, SSL-сертификаты проверяться не будут. Задавайте значение `false` только для сайтов под вашим личным контролем, использующих самоподписанные сертификаты. Если значение не задано в задаче, вместо него будет использовано значение переменной окружения `MSO_VALIDATE_CERTS`. Значение по умолчанию — `true`. Допустимые значения: `false` `true`

Примечания

Примечание

Перед использованием этого модуля в плейбуке должен существовать template. Используйте cisco.mso.ndo_template для создания шаблона арендатора.
Этот модуль разработан для поддержки Multi Site Orchestrator версии 2.1 или новее. Часть функций или все функции могут не работать в более ранних версиях.

См. также

cisco.mso.ndo_template: Управление шаблонами в Cisco Nexus Dashboard Orchestrator (NDO).

Примеры

- name: Create a new IGMP Snooping Policy object
  cisco.mso.ndo_tenant_igmp_snooping_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: tenant_template
    name: igmp_snooping_policy_1
    admin_state: enabled
    fast_leave_control: enabled
    querier_control: enabled
    querier_version: v2
    query_interval: 100
    query_response_interval: 5
    last_member_query_interval: 2
    start_query_interval: 25
    start_query_count: 1
    state: present
  register: igmp_snooping_policy_1

- name: Update a IGMP Snooping Policy object name with UUID
  cisco.mso.ndo_tenant_igmp_snooping_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: tenant_template
    name: igmp_snooping_policy_2
    uuid: "{{ igmp_snooping_policy_1.current.uuid }}"
    state: present

- name: Query a IGMP Snooping Policy object with name
  cisco.mso.ndo_tenant_igmp_snooping_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: tenant_template
    name: igmp_snooping_policy_1
    state: query
  register: query_uuid

- name: Query a IGMP Snooping Policy object with UUID
  cisco.mso.ndo_tenant_igmp_snooping_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: tenant_template
    uuid: "{{ igmp_snooping_policy_1.current.uuid }}"
    state: query
  register: query_uuid

- name: Query all IGMP Snooping Policy objects in a Tenant Template
  cisco.mso.ndo_tenant_igmp_snooping_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: tenant_template
    state: query
  register: query_all

- name: Delete a IGMP Snooping Policy object with name
  cisco.mso.ndo_tenant_igmp_snooping_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: tenant_template
    name: igmp_snooping_policy_1
    state: absent

- name: Delete a IGMP Snooping Policy object with UUID
  cisco.mso.ndo_tenant_igmp_snooping_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: tenant_template
    uuid: "{{ igmp_snooping_policy_1.current.uuid }}"
    state: absent

Авторы

Anvitha Jain (@anvjain)

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

© 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/mso/ndo_tenant_igmp_snooping_policy_module.html