Модуль cisco.mso.ndo_ntp_policy — управление политиками NTP в шаблонах политик фабрики в 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_ntp_policy.

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

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

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

Требования

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

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

Параметры

Параметр	Комментарии
admin_state string	Включить административное состояние. Значение по умолчанию: `admin_state=enabled`. Варианты: `"enabled"` `"disabled"`
authentication_state string	Включить состояние аутентификации. Значение по умолчанию: `authentication_state=disabled`. Варианты: `"enabled"` `"disabled"`
description string	Описание политики NTP. Если указать пустую строку, из политики NTP будет удалено `description=""`.
host псевдонимы: hostname string	IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_HOST`.
login_domain string	Имя домена входа, используемого для аутентификации. Значение по умолчанию: Local. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании подключаемого модуля соединения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаризации `ansible_httpapi_login_domain`.
master_mode string	Включить режим ведущего устройства. Значение по умолчанию: `master_mode=disabled`. Варианты: `"enabled"` `"disabled"`
name псевдонимы: ntp_policy string	Имя политики NTP.
ntp_keys list / элементы=dictionary	Список ключей аутентификации клиента NTP. Передача нового списка `ntp_keys` полностью заменит существующий список в политике NTP. Передача пустого списка удалит `ntp_keys=[]` из политики NTP.
authentication_type string	Тип аутентификации. Значение по умолчанию: `ntp_keys.authentication_type=md5`. Варианты: `"md5"` `"sha1"`
id псевдонимы: key_id integer / обязательный	Идентификатор ключа. Значение должно находиться в диапазоне от 1 до 65535.
key string	Ключ. Не более 40 буквенно-цифровых символов.
trusted boolean	Назначить ключ аутентификации клиента NTP доверенным. Варианты: `false` `true`
ntp_providers list / элементы=dictionary	Список поставщиков NTP. Передача нового списка `ntp_providers` полностью заменит существующий список в политике NTP. Передача пустого списка удалит `ntp_providers=[]` из политики NTP.
authentication_key_id псевдонимы: key_id integer	Идентификатор ключа аутентификации NTP. Значение должно находиться в диапазоне от 1 до 65535.
host string / обязательный	Имя хоста или IP-адрес поставщика NTP.
management_epg псевдонимы: epg string / обязательный	Управляющая EPG.
management_epg_type псевдонимы: epg_type string / обязательный	Тип управляющей EPG. Варианты: `"inb"` `"oob"`
maximum_poll_interval псевдонимы: max_poll integer	Максимальное значение интервала опроса. Значение по умолчанию: `ntp_providers.maximum_poll_interval=6`. Значение должно находиться в диапазоне от 4 до 16.
minimum_poll_interval псевдонимы: min_poll integer	Минимальное значение интервала опроса. Значение по умолчанию: `ntp_providers.minimum_poll_interval=4`. Значение должно находиться в диапазоне от 4 до 16.
preferred boolean	Назначить поставщика NTP предпочтительным. Варианты: `false` `true`
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`.
server_state string	Включить состояние сервера. Значение по умолчанию: `server_state=disabled`. Варианты: `"enabled"` `"disabled"`
state string	Для удаления используйте `absent`. Для просмотра одного или нескольких объектов используйте `query`. Для создания или обновления используйте `present`. Варианты: `"absent"` `"query"` ← (по умолчанию) `"present"`
stratum integer	Числовое значение уровня stratum. Значение по умолчанию: `stratum=4`. Значение должно находиться в диапазоне от 1 до 14.
template псевдонимы: fabric_policy_template string	Имя шаблона политики фабрики. Этот параметр или `template_id` является обязательным.
template_id псевдонимы: fabric_policy_template_id string	Идентификатор шаблона политики фабрики. Этот параметр или `template` является обязательным.
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`. При использовании подключаемого модуля соединения HTTPAPI (mso или nd) значение по умолчанию — `false`, а при использовании устаревшего метода соединения (только для mso) — `true`. Варианты: `false` `true`
username string	Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
uuid псевдонимы: ntp_policy_uuid string	UUID политики NTP. Этот параметр обязателен, если требуется обновить политику NTP `name`.
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 NTP Policy object
  cisco.mso.ndo_ntp_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: fabric_policy_template
    name: ntp_policy_1
    ntp_keys:
      - id: 1
        key: my_key
        authentication_type: md5
        trusted: true
    ntp_providers:
      - host: background
        minimum_poll_interval: 4
        maximum_poll_interval: 16
        management_epg_type: oob
        management_epg: default
        preferred: true
        authentication_key_id: 1
    admin_state: enabled
    server_state: enabled
    master_mode: enabled
    stratum: 4
    authentication_state: enabled
    state: present
  register: ntp_policy_1

- name: Update a NTP Policy object name with UUID
  cisco.mso.ndo_ntp_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: fabric_policy_template
    name: ntp_policy_2
    uuid: "{{ ntp_policy_1.current.uuid }}"
    state: present

- name: Query a NTP Policy object with name
  cisco.mso.ndo_ntp_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: fabric_policy_template
    name: ntp_policy_2
    state: query
  register: query_name

- name: Query a NTP Policy object with UUID
  cisco.mso.ndo_ntp_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: fabric_policy_template
    uuid: "{{ ntp_policy_1.current.uuid }}"
    state: query
  register: query_uuid

- name: Query all NTP Policy objects in a Fabric Policy Template
  cisco.mso.ndo_ntp_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: fabric_policy_template
    state: query
  register: query_all

- name: Delete a NTP Policy object with name
  cisco.mso.ndo_ntp_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: fabric_policy_template
    name: ntp_policy_2
    state: absent

- name: Delete a NTP Policy object with UUID
  cisco.mso.ndo_ntp_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: fabric_policy_template
    uuid: "{{ ntp_policy_1.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_ntp_policy_module.html