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

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

Описание

Управление списками отслеживания соглашений об уровне обслуживания IP (SLA) в Cisco Nexus Dashboard Orchestrator (NDO).
Этот модуль поддерживается только в ND версии 3.1 (NDO версии 4.3) и более поздних.

Требования

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

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

Параметры

Параметр	Комментарии
description string	Описание списка отслеживания IPSLA.
host псевдонимы: hostname string	IP-адрес или имя узла ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_HOST`.
ipsla_track_list псевдонимы: name string	Имя списка отслеживания IPSLA.
ipsla_track_list_uuid псевдонимы: uuid string	UUID списка отслеживания IPSLA. Этот параметр обязателен, если необходимо обновить атрибут `ipsla_track_list`.
login_domain string	Имя домена входа для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании подключаемого модуля подключения HTTPAPI будет использоваться переменная инвентаризации `ansible_httpapi_login_domain`, если этот атрибут не указан.
members list / элементы=dictionary	Элементы списка отслеживания IPSLA. При передаче нового списка `members` существующие элементы списка отслеживания IPSLA будут заменены. Передача пустого списка удалит `members=[]` из списка отслеживания IPSLA.
destination_ip псевдонимы: ip string / обязательный	IP-адрес назначения элемента. Должен быть допустимым адресом IPv4 или IPv6.
ipsla_monitoring_policy dictionary	Политика мониторинга IPSLA, используемая для элемента. Необходимо указать этот параметр или `members.ipsla_monitoring_policy_uuid`.
name string / обязательный	Имя политики мониторинга IPSLA, используемой для элемента.
ipsla_monitoring_policy_uuid string	UUID политики мониторинга IPSLA, используемой для элемента. Необходимо указать этот параметр или `members.ipsla_monitoring_policy`.
scope dictionary	BD или L3Out, используемый в качестве области действия для элемента. Необходимо указать этот параметр или `members.scope_uuid`.
name string / обязательный	Имя BD или L3Out, используемого в качестве области действия для элемента.
schema string	Имя схемы, связанной с областью действия BD. Этот параметр или `members.scope.schema_id` обязателен только при условии `members.scope_type=bd`.
schema_id string	Идентификатор схемы, связанной с областью действия BD. Этот параметр или `members.scope.schema` обязателен только при условии `members.scope_type=bd`.
template string	Имя шаблона, связанного с областью действия BD или L3Out. Необходимо указать этот параметр или `members.scope.template_id`.
template_id string	Идентификатор шаблона, связанного с областью действия BD или L3Out. Необходимо указать этот параметр или `members.scope.template`.
scope_type string / обязательный	Тип области действия элемента. Допустимые значения: `"bd"` `"l3out"`
scope_uuid string	UUID BD или L3Out, используемого в качестве области действия для элемента. Необходимо указать этот параметр или `members.scope`.
weight integer	Вес элемента. Значение по умолчанию — 10.
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`.
state string	Для удаления используйте `absent`. Для вывода одного или нескольких объектов используйте `query`. Для создания или обновления используйте `present`. Допустимые значения: `"absent"` `"query"` `"present"` ← (по умолчанию)
template string	Имя шаблона. Шаблон должен быть шаблоном арендатора. Необходимо указать этот параметр или `template_id`.
template_id string	Идентификатор шаблона. Шаблон должен быть шаблоном арендатора. Необходимо указать этот параметр или `template`.
threshold_down псевдонимы: down integer	Пороговое значение процента или веса для состояния «не работает» списка отслеживания IPSLA. При условии `type=percentage` значение должно находиться в диапазоне от 0 до 100. При условии `type=weight` значение должно находиться в диапазоне от 0 до 255. Значение должно быть меньше или равно `threshold_up`. Значение по умолчанию — 0.
threshold_up псевдонимы: up integer	Пороговое значение процента или веса для состояния «работает» списка отслеживания IPSLA. При условии `type=percentage` значение должно находиться в диапазоне от 0 до 100. При условии `type=weight` значение должно находиться в диапазоне от 0 до 255. Значение должно быть больше или равно `threshold_down`. Значение по умолчанию — 1.
timeout integer	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_TIMEOUT`.
type string	Тип списка отслеживания IPSLA, используемый для определения состояния «работает» или «не работает». Этот параметр обязателен при создании списка отслеживания IPSLA. Допустимые значения: `"percentage"` `"weight"`
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`.
validate_certs boolean	Если `false`, SSL-сертификаты проверяться не будут. Устанавливайте значение `false` только на сайтах под вашим контролем, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_VALIDATE_CERTS`. Значение по умолчанию — `true`. Допустимые значения: `false` `true`

Примечания

Примечание

Перед использованием этого модуля в плейбуке необходимо создать template. Используйте cisco.mso.ndo_template для создания шаблона арендатора.
Перед добавлением members необходимо создать members.ipsla_monitoring_policy. Используйте cisco.mso.ndo_ipsla_monitoring_policy для создания политики мониторинга IPSLA.
Перед добавлением members необходимо создать members.scope типа BD или L3Out. Используйте cisco.mso.ndo_l3out_template для создания L3Out. Используйте cisco.mso.mso_schema_template_bd для создания BD.
Этот модуль создан для поддержки Multi Site Orchestrator версии 2.1 или новее. Некоторые или все функции могут не работать в более ранних версиях.

См. также

cisco.mso.ndo_template: Управление шаблонами в Cisco Nexus Dashboard Orchestrator (NDO).
cisco.mso.ndo_ipsla_monitoring_policy: Управление политиками мониторинга IPSLA в Cisco Nexus Dashboard Orchestrator (NDO).
cisco.mso.ndo_l3out_template: Управление L3Out в Cisco Nexus Dashboard Orchestrator (NDO).
cisco.mso.mso_schema_template_bd: Управление доменами широковещания (BD) в шаблонах схем.

Примеры

- name: Create a new IPSLA Track List
  cisco.mso.ndo_ipsla_track_list:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    ipsla_track_list: ansible_test_ipsla_track_list
    description: Example track list
    type: percentage
    threshold_up: 10
    threshold_down: 2
    members:
      - destination_ip: 1.1.1.1
        scope_type: bd
        scope:
          name: ansible_test_bd
          template: ansible_test_template
          schema: ansible_test_schema
        ipsla_monitoring_policy:
          name: ansible_test_ipsla_monitoring_policy
      - destination_ip: 2001:0000:130F:0000:0000:09C0:876A:130B
        scope_type: l3out
        scope:
          name: ansible_test_l3out
          template: ansible_test_template
        ipsla_monitoring_policy_uuid: "{{ ipsla_mon_pol.current.uuid }}"
      - destination_ip: 1.1.1.2
        scope_type: l3out
        scope_uuid: "{{ l3out.current.uuid }}"
        ipsla_monitoring_policy:
          name: ansible_test_ipsla_monitoring_policy
    state: present
    register: ipsla_track_list

- name: Update an IPSLA Track List name with UUID
  cisco.mso.ndo_ipsla_track_list:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    ipsla_track_list: ansible_test_ipsla_track_list_updated
    ipsla_track_list_uuid: "{{ ipsla_track_list.current.uuid }}"
    state: present
  register: ipsla_track_list_update

- name: Query an IPSLA Track List with name
  cisco.mso.ndo_ipsla_track_list:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    ipsla_track_list: ansible_test_ipsla_track_list
    state: query
  register: query_one

- name: Query an IPSLA Track List with UUID
  cisco.mso.ndo_ipsla_track_list:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    ipsla_track_list_uuid: "{{ query_one.current.uuid }}"
    state: query
  register: query_one_uuid

- name: Query all IPSLA Track Lists in the template
  cisco.mso.ndo_ipsla_track_list:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    state: query
  register: query_all

- name: Remove all members from an IPSLA Track List
  cisco.mso.ndo_ipsla_track_list:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    ipsla_track_list: ansible_test_ipsla_track_list
    type: percentage
    members: []
    state: present

- name: Delete an IPSLA Track List with name
  cisco.mso.ndo_ipsla_track_list:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    ipsla_track_list: ansible_test_ipsla_track_list
    state: absent

- name: Delete an IPSLA Track List with UUID
  cisco.mso.ndo_ipsla_track_list:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    ipsla_track_list_uuid: "{{ query_one.current.uuid }}"
    state: absent

Авторы

Samita Bhattacharjee (@samitab)

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

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