модуль cisco.mso.ndo_pod_settings — управление настройками Pod в 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_pod_settings.

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

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

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

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

Требования

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

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

Параметры

Параметр	Комментарии
description string	Описание настроек Pod.
host псевдонимы: hostname string	IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_HOST`.
login_domain string	Имя домена входа, используемое для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаризации `ansible_httpapi_login_domain`.
macsec_policy dictionary	Политика MACsec, которую следует использовать. Этот параметр является взаимоисключающим с `macsec_policy_uuid`. Если передать пустой словарь `macsec_policy={}`, политика MACsec будет удалена из настроек Pod.
name string	Имя используемой политики MACsec.
macsec_policy_uuid string	UUID используемой политики MACsec. Если передать пустую строку `macsec_policy_uuid=""`, политика MACsec будет удалена из настроек Pod. Этот параметр является взаимоисключающим с `macsec_policy`.
name псевдонимы: pod_settings string	Имя настроек Pod.
ntp_policy dictionary	Политика NTP, которую следует использовать. Этот параметр является взаимоисключающим с `ntp_policy_uuid`. Если передать пустой словарь `ntp_policy={}`, политика NTP будет удалена из настроек Pod.
name string	Имя используемой политики NTP.
ntp_policy_uuid string	UUID используемой политики NTP. Если передать пустую строку `ntp_policy_uuid=""`, политика NTP будет удалена из настроек Pod. Этот параметр является взаимоисключающим с `ntp_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`.
state string	Для удаления используйте `absent`. Для получения списка одного или нескольких объектов используйте `query`. Для создания или обновления используйте `present`. Варианты: `"absent"` `"query"` ← (по умолчанию) `"present"`
template string	Имя шаблона. Шаблон должен быть шаблоном Fabric Policy. Необходимо указать этот параметр или `template_id`.
template_id string	ID шаблона. Шаблон должен быть шаблоном Fabric Policy. Необходимо указать этот параметр или `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`. По умолчанию используется `false` при работе с плагином подключения HTTPAPI (mso или nd) и `true` при использовании устаревшего метода подключения (только для mso). Варианты: `false` `true`
username string	Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
uuid псевдонимы: pod_settings_uuid string	UUID настроек Pod. Этот параметр обязателен, если требуется обновить `name`.
validate_certs boolean	Если задано значение `false`, SSL-сертификаты проверяться не будут. Значение `false` следует задавать только для подконтрольных вам сайтов, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_VALIDATE_CERTS`. Значение по умолчанию — `true`. Варианты: `false` `true`

Примечания

Примечание

Перед использованием этого модуля в плейбуке должен существовать template. Используйте cisco.mso.ndo_template для создания шаблона Fabric Policy.
Перед использованием с этим модулем в плейбуке должна существовать macsec_policy или macsec_policy_uuid. Используйте cisco.mso.ndo_macsec_policy для создания политики MACsec.
Перед использованием с этим модулем в плейбуке должна существовать ntp_policy или ntp_policy_uuid. Используйте cisco.mso.ndo_ntp_policy для создания политики NTP.
Этот модуль разработан для Multi Site Orchestrator версии 2.1 или новее. Некоторые или все его функции могут не работать в более ранних версиях.

См. также

cisco.mso.ndo_template: Управление шаблонами в Cisco Nexus Dashboard Orchestrator (NDO).
cisco.mso.ndo_macsec_policy: Управление политиками MACsec в Cisco Nexus Dashboard Orchestrator (NDO).
cisco.mso.ndo_ntp_policy: Управление политиками NTP в шаблонах Fabric Policy в Cisco Nexus Dashboard Orchestrator (NDO).

Примеры

- name: Create Pod Settings
  cisco.mso.ndo_pod_settings:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    name: ansible_pod_settings
    state: present
  register: create_pod_settings

- name: Update Pod Settings
  cisco.mso.ndo_pod_settings:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    name: ansible_pod_settings
    description: Updated Pod Settings
    macsec_policy:
      name: ansible_macsec_policy
    ntp_policy:
      name: ansible_ntp_policy
    state: present

- name: Update the Pod Settings using UUID
  cisco.mso.ndo_pod_settings:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    uuid: "{{ create_pod_settings.current.uuid }}"
    macsec_policy_uuid: "{{ create_macsec_policy.current.uuid }}"
    ntp_policy_uuid: "{{ create_ntp_policy.current.uuid }}"
    state: present

- name: Query the Pod Settings using name
  cisco.mso.ndo_pod_settings:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    name: ansible_pod_settings
    state: query
  register: query_with_name

- name: Query the Pod Settings using UUID
  cisco.mso.ndo_pod_settings:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    uuid: "{{ create_pod_settings.current.uuid }}"
    state: query
  register: query_with_uuid

- name: Query all Pod Settings in a template
  cisco.mso.ndo_pod_settings:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    state: query
  register: query_all_objects

- name: Delete the Pod Settings using Name
  cisco.mso.ndo_pod_settings:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test
    name: ansible_pod_settings
    state: absent

- name: Delete the Pod Settings using UUID
  cisco.mso.ndo_pod_settings:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template_id: ansible_test
    uuid: "{{ create_pod_settings.current.uuid }}"
    state: absent

Авторы

Akini Ross (@akinross)

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

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