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

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

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

Обзор

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

Требования

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

Multi Site Orchestrator v2.1 или более поздней версии

Параметры

Параметр	Комментарии
aggregate boolean	Флаг aggregate, включающий агрегацию маршрутов. При создании по умолчанию используется `false`, если значение не задано. Варианты: `false` `true`
description string	Описание префикса соответствия.
from_prefix псевдонимы: from integer	Значение маски подсети, от которого выполняется агрегация. Значение должно быть меньше `to_prefix` и больше маски подсети IP-адреса префикса. Значение должно находиться в диапазоне от 0 до 32. При создании по умолчанию используется `0`, если значение не задано.
host псевдонимы: hostname string	IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `MSO_HOST`.
login_domain string	Имя домена входа, используемого для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `MSO_LOGIN_DOMAIN`. При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаря `ansible_httpapi_login_domain`.
match_rule_policy string	Имя политики правил соответствия. Необходимо указать этот параметр или `match_rule_policy_uuid`.
match_rule_policy_uuid string	UUID политики правил соответствия. Необходимо указать этот параметр или `match_rule_policy`.
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`.
prefix string	IP-префикс для сопоставления.
state string	Для удаления используйте `absent`. Для отображения одного или нескольких объектов используйте `query`. Для создания или обновления используйте `present`. Варианты: `"absent"` `"query"` ← (по умолчанию) `"present"`
template string	Имя шаблона. Шаблон должен быть шаблоном политики арендатора. Необходимо указать этот параметр или `template_id`.
template_id string	Идентификатор шаблона. Шаблон должен быть шаблоном политики арендатора. Необходимо указать этот параметр или `template`.
timeout integer	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `MSO_TIMEOUT`.
to_prefix псевдонимы: to integer	Значение маски подсети, до которого выполняется агрегация. Значение должно быть больше `from_prefix` и больше маски подсети IP-адреса префикса. Значение должно находиться в диапазоне от 0 до 32. При создании по умолчанию используется `0`, если значение не задано.
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`.
validate_certs boolean	Если `false`, SSL-сертификаты не будут проверяться. Значение `false` следует задавать только для контролируемых вами сайтов, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `MSO_VALIDATE_CERTS`. По умолчанию используется `true`. Варианты: `false` `true`

Примечания

Примечание

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

См. также

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

Примеры

- name: Create a Match Prefix
  cisco.mso.ndo_match_rule_prefix:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    match_rule_policy: ansible_match_rule_policy
    prefix: 10.10.10.1/24
    description: Ansible Match Prefix
    aggregate: false
    from_prefix: 0
    to_prefix: 0
    state: present
  register: create_match_prefix

- name: Update a Match Prefix using Match Rule Policy's name
  cisco.mso.ndo_match_rule_prefix:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    match_rule_policy: ansible_match_rule_policy
    prefix: 10.10.10.1/24
    description: Updated Ansible Match Prefix
    aggregate: true
    from_prefix: 25
    to_prefix: 31
    state: present

- name: Update a Match Prefix using Match Rule Policy's UUID
  cisco.mso.ndo_match_rule_prefix:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    match_rule_policy_uuid: "{{ create_match_prefix.current.matchRulePolicyUuid }}"
    prefix: 10.10.10.1/24
    description: Updated Ansible Match Prefix
    aggregate: true
    from_prefix: 25
    to_prefix: 31
    state: present

- name: Query a Match Prefix using Match Rule Policy's name
  cisco.mso.ndo_match_rule_prefix:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    match_rule_policy: ansible_match_rule_policy
    prefix: 10.10.10.1/24
    state: query
  register: query_with_name

- name: Query a Match Prefix using  Match Rule Policy's UUID
  cisco.mso.ndo_match_rule_prefix:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    match_rule_policy_uuid: "{{ create_match_prefix.current.matchRulePolicyUuid }}"
    prefix: 10.10.10.1/24
    state: query
  register: query_with_uuid

- name: Query all Match Prefixes in a Match Rule Policy
  cisco.mso.ndo_match_rule_prefix:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    match_rule_policy: ansible_match_rule_policy
    state: query
  register: query_all_objects

- name: Delete a Match Prefix using Match Rule Policy's name
  cisco.mso.ndo_match_rule_prefix:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    match_rule_policy: ansible_match_rule_policy
    prefix: 10.10.10.1/24
    state: absent

- name: Delete a Match Prefix using Match Rule Policy's UUID
  cisco.mso.ndo_match_rule_prefix:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template_id: ansible_test
    match_rule_policy_uuid: "{{ create_match_prefix.current.matchRulePolicyUuid }}"
    prefix: 10.10.10.1/24
    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_prefix_module.html