Модуль cisco.mso.ndo_mcp_global_policy — управление глобальной политикой MCP в шаблоне политики Fabric в 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_mcp_global_policy.

Обзор
Требования
Параметры
Примечания
См. также
Примеры

Обзор

Управление глобальной политикой протокола обнаружения ошибочной коммутации (MisCabling Protocol, MCP) в шаблоне политики Fabric в Cisco Nexus Dashboard Orchestrator (NDO).
В шаблоне политики Fabric может быть только одна глобальная политика MCP.
Этот модуль поддерживается только в ND v3.1 (NDO v4.3) и более поздних версиях.

Требования

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

Multi Site Orchestrator v2.1 или новее

Параметры

Параметр	Комментарии
admin_state string	Административное состояние глобальной политики MCP. При создании по умолчанию используется `enabled`, если значение не задано. Варианты: `"enabled"` `"disabled"`
description string	Описание глобальной политики MCP. Если указать пустую строку, из глобальной политики MCP будет удалено `description=""`.
host псевдонимы: hostname string	IP-адрес или имя хоста узла ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_HOST`.
initial_delay_time псевдонимы: initial_delay integer	Начальная задержка MCP в секундах. При создании по умолчанию используется значение 180, если значение не задано. Значение должно находиться в диапазоне от 0 до 1800.
key string	Ключ глобальной политики MCP.
login_domain string	Имя домена входа, используемого для аутентификации. По умолчанию используется значение Local. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_LOGIN_DOMAIN`. При использовании подключаемого модуля соединения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаря `ansible_httpapi_login_domain`.
loop_detection_factor псевдонимы: loop_factor, loop_detection_mult_factor integer	Количество пакетов MCP, которое должно быть получено до срабатывания защиты от петель с отключением порта. При создании по умолчанию используется значение 3, если значение не задано. Значение должно находиться в диапазоне от 1 до 255.
name псевдонимы: mcp_global_policy string	Имя глобальной политики MCP.
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`.
per_vlan псевдонимы: per_epg, mcp_pdu_per_vlan string	Если параметр включен, MCP будет отправлять пакеты отдельно для каждой группы конечных точек (EPG). Если параметр отключен, пакеты будут отправляться только для EPG без тегов, что позволяет обнаруживать петли только в исходной VLAN. При создании по умолчанию используется `disabled`, если значение не задано. Варианты: `"enabled"` `"disabled"`
port integer	Номер порта для REST-соединения. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_PORT`.
port_disable псевдонимы: port_disable_protection string	Включение или отключение отключения порта при получении пакетов MCP. При создании по умолчанию используется `enabled`, если значение не задано. Варианты: `"enabled"` `"disabled"`
state string	Для удаления используйте `absent`. Для просмотра одного или нескольких объектов используйте `query`. Для создания или обновления используйте `present`. Варианты: `"absent"` `"query"` ← (по умолчанию) `"present"`
template псевдонимы: fabric_template string / обязательный	Имя шаблона. Шаблон должен быть шаблоном политики Fabric.
timeout integer	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_TIMEOUT`.
transmission_frequency_msec псевдонимы: tx_freq_ms integer	Частота передачи MCP в миллисекундах. При создании по умолчанию используется значение 0, если значение не задано. Значение должно находиться в диапазоне от 0 до 999.
transmission_frequency_sec псевдонимы: tx_freq integer	Частота передачи MCP в секундах. При создании по умолчанию используется значение 2, если значение не задано. Значение должно находиться в диапазоне от 0 до 300.
use_proxy boolean	Если `false`, прокси-сервер использоваться не будет, даже если он задан в переменной окружения на целевых хостах. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_USE_PROXY`. По умолчанию используется `true`. Варианты: `false` `true`
use_ssl boolean	Если `false`, вместо HTTPS-соединения, используемого по умолчанию, будет установлено HTTP-соединение. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_USE_SSL`. При использовании подключаемого модуля соединения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаря `ansible_httpapi_use_ssl`. По умолчанию используется `false` при использовании подключаемого модуля соединения HTTPAPI (mso или nd) и `true` при использовании устаревшего метода соединения (только для mso). Варианты: `false` `true`
username string	Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него будут использованы значения переменных окружения `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
uuid псевдонимы: mcp_global_policy_uuid string	UUID глобальной политики MCP.
validate_certs boolean	Если `false`, SSL-сертификаты проверяться не будут. Значение `false` следует задавать только для сайтов под личным контролем, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_VALIDATE_CERTS`. По умолчанию используется `true`. Варианты: `false` `true`

Примечания

Примечание

Перед использованием этого модуля в плейбуке должен существовать template. Для создания шаблона политики Fabric используйте cisco.mso.ndo_template.
Попытки создать дополнительные глобальные политики MCP приведут только к обновлению существующего объекта в шаблоне политики Fabric.
Этот модуль разработан для Multi Site Orchestrator v2.1 или новее. Часть или все функции могут не работать в более ранних версиях.

См. также

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

Примеры

- name: Create the MCP Global Policy object
  cisco.mso.ndo_mcp_global_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: fabric_template
    name: example_mcp_global_policy
    state: present
  register: mcp_global_policy_new

- name: Create the MCP Global Policy object with all attributes
  cisco.mso.ndo_mcp_global_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: fabric_template
    name: example_mcp_global_policy
    description: A Global MCP Policy
    key: cisco
    admin_state: enabled
    per_vlan: enabled
    loop_detection_factor: 3
    port_disable: enabled
    initial_delay_time: 180
    transmission_frequency_sec: 2
    transmission_frequency_msec: 10
    state: present
  register: mcp_global_policy_all

- name: Update the MCP Global Policy object with UUID
  cisco.mso.ndo_mcp_global_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: fabric_template
    name: mcp_global_policy_update
    uuid: "{{ mcp_global_policy_all.current.uuid }}"
    state: present

- name: Query the MCP Global Policy object with name
  cisco.mso.ndo_mcp_global_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: fabric_template
    name: example_mcp_global_policy
    state: query
  register: query_name

- name: Query the MCP Global Policy object with UUID
  cisco.mso.ndo_mcp_global_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: fabric_template
    uuid: "{{ mcp_global_policy_all.current.uuid }}"
    state: query
  register: query_uuid

- name: Query the MCP Global Policy object in a Fabric Template
  cisco.mso.ndo_mcp_global_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: fabric_template
    state: query
  register: query_all

- name: Delete the MCP Global Policy object with name
  cisco.mso.ndo_mcp_global_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: fabric_template
    name: example_mcp_global_policy
    state: absent

- name: Delete the MCP Global Policy object with UUID
  cisco.mso.ndo_mcp_global_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: fabric_template
    uuid: "{{ mcp_global_policy_all.current.uuid }}"
    state: absent

Авторы

Samita Bhattacharjee (@samiib)

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

© 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_mcp_global_policy_module.html