модуль cisco.mso.ndo_ipsla_monitoring_policy — управление политиками мониторинга IPSLA в 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_ipsla_monitoring_policy.

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

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

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

Требования

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

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

Параметры

Параметр	Комментарии
description string	Описание политики мониторинга IPSLA.
destination_port integer	Порт, используемый для SLA. Применимо только при `sla_type=tcp` или `sla_type=http`. При `sla_type=http` значением по умолчанию является 80. При `sla_type=tcp` значение должно находиться в диапазоне 1–65535.
detect_multiplier integer	Множитель обнаружения для SLA. Значение должно находиться в диапазоне 1–100. Значение по умолчанию — 3.
host псевдонимы: hostname string	IP-адрес или имя хоста узла ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_HOST`.
http_uri string	URI, используемый для HTTP SLA. Применимо только при `sla_type=http`. Значение по умолчанию — ‘/’.
http_version string	Версия HTTP, используемая для SLA. Применимо только при `sla_type=http`. Значение по умолчанию — `HTTP10`. Допустимые значения: `"HTTP10"` `"HTTP11"`
ipsla_monitoring_policy псевдонимы: name string	Имя политики мониторинга IPSLA.
ipsla_monitoring_policy_uuid псевдонимы: uuid string	UUID политики мониторинга IPSLA. Этот параметр необходим, если требуется обновить атрибут `ipsla_monitoring_policy`.
ipv6_traffic_class integer	Класс трафика IPv6. Значение должно находиться в диапазоне 0–255. Значение по умолчанию — 0.
login_domain string	Имя домена входа, используемое для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_LOGIN_DOMAIN`. При использовании подключаемого модуля соединения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаря `ansible_httpapi_login_domain`.
operation_timeout integer	Тайм-аут операции SLA в миллисекундах. Значение по умолчанию — 900 миллисекунд.
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`.
request_data_size integer	Размер данных запроса в байтах. Значение должно находиться в диапазоне 0–17513. Значение по умолчанию — 28 байт.
sla_frequency integer	Частота мониторинга SLA в секундах. Значение должно находиться в диапазоне 1–300. Значение по умолчанию — 60 секунд.
sla_type string	Тип SLA. Значение по умолчанию — `icmp`. Допустимые значения: `"http"` `"tcp"` `"icmp"` `"l2ping"`
state string	Используйте `absent` для удаления. Используйте `query` для вывода одного или нескольких объектов. Используйте `present` для создания или обновления. Допустимые значения: `"absent"` `"query"` ← (по умолчанию) `"present"`
template string / обязательный	Имя шаблона. Шаблон должен быть шаблоном арендатора.
threshold integer	Пороговое значение SLA в миллисекундах. Значение по умолчанию — 900 миллисекунд.
timeout integer	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_TIMEOUT`.
type_of_service integer	Тип обслуживания IPv4. Значение должно находиться в диапазоне 0–255. Значение по умолчанию — 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`

Примечания

Примечание

Этот модуль разработан для поддержки Multi Site Orchestrator v2.1 или новее. Некоторые или все функции могут не работать в более ранних версиях.

Примеры

- name: Create a new IPSLA monitoring policy
  cisco.mso.ndo_ipsla_monitoring_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    ipsla_monitoring_policy: ansible_test_ipsla_monitoring_policy
    sla_type: http
    http_version: HTTP11
    http_uri: /test
    sla_frequency: 120
    detect_multiplier: 5
    request_data_size: 64
    type_of_service: 16
    operation_timeout: 1000
    threshold: 1000
    ipv6_traffic_class: 32
    state: present

- name: Query an IPSLA monitoring policy with name
  cisco.mso.ndo_ipsla_monitoring_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    ipsla_monitoring_policy: ansible_test_ipsla_monitoring_policy
    state: query
  register: query_one

- name: Query all IPSLA monitoring policies in the template
  cisco.mso.ndo_ipsla_monitoring_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    state: query
  register: query_all

- name: Delete an IPSLA monitoring policy
  cisco.mso.ndo_ipsla_monitoring_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    ipsla_monitoring_policy: ansible_test_ipsla_monitoring_policy
    state: absent

- name: Query an IPSLA monitoring policy with UUID
  cisco.mso.ndo_ipsla_monitoring_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    ipsla_monitoring_policy_uuid: "{{ query_one.current.uuid }}"
    state: query
  register: query_one_uuid

- name: Delete an IPSLA monitoring policy with UUID
  cisco.mso.ndo_ipsla_monitoring_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    ipsla_monitoring_policy_uuid: "{{ query_one.current.uuid }}"
    state: absent

Авторы

Shreyas Srish (@shrsr)

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

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