модуль cisco.mso.ndo_ptp_policy — управление политиками PTP в 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_ptp_policy.

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

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

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

Требования

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

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

Параметры

Параметр	Комментарии
admin_state string	Административное состояние политики PTP. Допустимые значения: `"enabled"` `"disabled"`
description string	Описание политики PTP.
fabric_announce_interval integer	Интервал отправки сообщений announce для политики PTP в фабрике. Значение должно находиться в диапазоне от 0 до 4. Это значение необходимо указать, если `state=present`.
fabric_announce_timeout integer	Тайм-аут сообщений announce для политики PTP в фабрике. Значение должно находиться в диапазоне от 2 до 10. Это значение необходимо указать, если `state=present`.
fabric_delay_interval integer	Интервал задержки для политики PTP в фабрике. Значение должно находиться в диапазоне от -3 до 5. Это значение необходимо указать, если `state=present`.
fabric_profile_template string	Шаблон профиля фабрики для политики PTP. Допустимые значения: `"aes67_2015"` `"default"` `"smpte_2059_2"`
fabric_sync_interval integer	Интервал синхронизации для политики PTP в фабрике. Значение должно находиться в диапазоне от -4 до 1. Это значение необходимо указать, если `state=present`.
global_domain integer	Номер глобального домена для политики PTP. Значение должно находиться в диапазоне от 1 до 128. Это значение необходимо указать, если `state=present`.
global_priority1 integer	Приоритет 1 для политики PTP. Значение должно находиться в диапазоне от 1 до 255. Это значение необходимо указать, если `state=present`.
global_priority2 integer	Приоритет 2 для политики PTP. Значение должно находиться в диапазоне от 1 до 255. Это значение необходимо указать, если `state=present`.
host псевдонимы: hostname string	IP-адрес или имя хоста узла ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_HOST`.
login_domain string	Имя домена входа для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании подключаемого модуля соединения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаризации `ansible_httpapi_login_domain`.
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`.
ptp_policy псевдонимы: name string	Имя политики PTP.
ptp_policy_uuid псевдонимы: uuid string	UUID политики PTP. Этот параметр обязателен, если необходимо обновить `ptp_policy`.
state string	Для удаления используйте `absent`. Для получения списка одного или нескольких объектов используйте `query`. Для создания или обновления используйте `present`. Допустимые значения: `"absent"` `"query"` ← (по умолчанию) `"present"`
template string / обязательный	Имя шаблона. Шаблон должен быть шаблоном политики фабрики.
timeout integer	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_TIMEOUT`.
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.
Этот модуль создан для поддержки Multi Site Orchestrator v2.1 или новее. Некоторые или все функции могут не работать в более ранних версиях.

См. также

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

Примеры

- name: Create a new PTP policy
  cisco.mso.ndo_ptp_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_fabric_policy_template
    ptp_policy: ansible_test_ptp_policy
    admin_state: enabled
    fabric_sync_interval: -3
    global_domain: 0
    fabric_delay_interval: -2
    global_priority1: 255
    global_priority2: 255
    fabric_announce_timeout: 3
    fabric_announce_interval: 1
    fabric_profile_template: aes67_2015
    state: present
  register: create_ptp

- name: Query a PTP policy with ptp_policy name
  cisco.mso.ndo_ptp_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_fabric_policy_template
    ptp_policy: ansible_test_ptp_policy
    state: query
  register: query_one

- name: Query a PTP policy with ptp_policy UUID
  cisco.mso.ndo_ptp_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_fabric_policy_template
    ptp_policy_uuid: "{{ create_ptp.current.uuid }}"
    state: query
  register: query_one_uuid

- name: Update a PTP policy name with UUID
  cisco.mso.ndo_ptp_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    ptp_policy: ansible_test_ptp_policy_updated
    ptp_policy_uuid: "{{ create_ptp.current.uuid }}"
    state: present

- name: Delete a PTP policy
  cisco.mso.ndo_ptp_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test_ptp_policy_updated
    ptp_policy: ansible_test_ptp_policy
    state: absent

- name: Delete a PTP policy using UUID
  cisco.mso.ndo_ptp_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_fabric_policy_template
    ptp_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_ptp_policy_module.html