модуль cisco.mso.ndo_match_rule_policy — управление политиками правил сопоставления в 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_match_rule_policy.

Добавлено в cisco.mso 2.12.0

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

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

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

Требования

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

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

Параметры

Параметр	Комментарии
description строка	Описание политики правила сопоставления.
host псевдонимы: hostname строка	IP-адрес или имя узла ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_HOST`.
login_domain строка	Имя домена входа, используемого для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании плагина подключения HTTPAPI, если этот атрибут не задан, будет использоваться переменная инвентаря `ansible_httpapi_login_domain`.
name псевдонимы: match_rule_policy строка	Имя политики правила сопоставления.
output_level строка	Настраивает состав выходных данных этого модуля MSO. `normal` означает стандартный вывод, включая словарь `current` `info` добавляет информационные данные, включая словари `previous`, `proposed` и `sent` `debug` добавляет отладочные данные, включая информацию `filter_string`, `method`, `response`, `status` и `url` Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_OUTPUT_LEVEL`. Варианты: `"debug"` `"info"` `"normal"` ← (по умолчанию)
password строка	Пароль для аутентификации. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_PASSWORD` или `ANSIBLE_NET_PASSWORD`.
port целое число	Номер порта для REST-подключения. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_PORT`.
state строка	Используйте `absent` для удаления. Используйте `query` для получения списка одного или нескольких объектов. Используйте `present` для создания или обновления. Варианты: `"absent"` `"query"` ← (по умолчанию) `"present"`
template строка	Имя шаблона. Шаблон должен быть шаблоном политики арендатора. Необходимо указать этот параметр или `template_id`.
template_id строка	Идентификатор шаблона. Шаблон должен быть шаблоном политики арендатора. Необходимо указать этот параметр или `template`.
timeout целое число	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_TIMEOUT`.
use_proxy логическое значение	Если задано `false`, прокси использоваться не будет, даже если он указан в переменной среды на целевых узлах. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_USE_PROXY`. Значение по умолчанию — `true`. Варианты: `false` `true`
use_ssl логическое значение	Если задано `false`, вместо HTTPS-подключения, используемого по умолчанию, будет использоваться HTTP-подключение. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_USE_SSL`. При использовании плагина подключения HTTPAPI, если этот атрибут не задан, будет использоваться переменная инвентаря `ansible_httpapi_use_ssl`. При использовании плагина подключения HTTPAPI (mso или nd) значение по умолчанию — `false`; при использовании устаревшего метода подключения (только для mso) — `true`. Варианты: `false` `true`
username строка	Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
uuid псевдонимы: match_rule_policy_uuid строка	UUID политики правила сопоставления. Этот параметр обязателен, если необходимо обновить `name`.
validate_certs логическое значение	Если задано `false`, SSL-сертификаты проверяться не будут. Значение `false` следует задавать только на контролируемых вами узлах, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_VALIDATE_CERTS`. Значение по умолчанию — `true`. Варианты: `false` `true`

Примечания

Примечание

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

См. также

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

Примеры

- name: Create a Match Rule Policy
  cisco.mso.ndo_match_rule_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    name: ansible_match_rule_policy
    description: Ansible Match Rule Policy
    state: present
  register: create_match_rule_policy

- name: Update a Match Rule Policy using name
  cisco.mso.ndo_match_rule_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    name: ansible_match_rule_policy
    description: Updated Ansible Match Rule Policy
    state: present

- name: Update a Match Rule Policy using UUID
  cisco.mso.ndo_match_rule_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    name: ansible_match_rule_policy_changed
    uuid: "{{ create_match_rule_policy.current.uuid }}"
    state: present

- name: Query a Match Rule Policy using name
  cisco.mso.ndo_match_rule_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    name: ansible_match_rule_policy
    state: query
  register: query_with_name

- name: Query a Match Rule Policy using UUID
  cisco.mso.ndo_match_rule_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    uuid: "{{ create_match_rule_policy.current.uuid }}"
    state: query
  register: query_with_uuid

- name: Query all Match Rule Policies in a template
  cisco.mso.ndo_match_rule_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    state: query
  register: query_all_objects

- name: Delete a Match Rule Policy using its name
  cisco.mso.ndo_match_rule_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    name: ansible_match_rule_policy
    state: absent

- name: Delete a Match Rule Policy using UUID
  cisco.mso.ndo_match_rule_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template_id: ansible_test
    uuid: "{{ create_match_rule_policy.current.uuid }}"
    state: absent

Авторы

Gaspard Micol (@gmicol)

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

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