Модуль cisco.mso.mso_site — Управление сайтами

Примечание

Этот модуль является частью коллекции cisco.mso (версия 2.9.0).

У вас может быть уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install cisco.mso. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.

Для использования в книге задач укажите: cisco.mso.mso_site.

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

Управление сайтами в Cisco ACI Multi-Site.

Требования

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

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

Параметры

Параметр	Комментарии
apic_login_domain строка	Домен AAA входа для имени пользователя для APIC. Атрибут apic_login_domain не поддерживается при использовании с платформой ND. См. коллекцию ND для полного управления сайтом.
apic_password строка	Пароль для APIC. Атрибут apic_password не поддерживается при использовании с платформой ND. См. коллекцию ND для полного управления сайтом.
apic_site_id строка	Идентификатор сайта APIC.
apic_username строка	Имя пользователя для APIC. Атрибут apic_username не поддерживается при использовании с платформой ND. См. коллекцию ND для полного управления сайтом. По умолчанию: `"admin"`
host псевдонимы: hostname строка	IP-адрес или имя хоста хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_HOST`
labels список / элементы=строка	Метки для этого сайта. Метки, которых еще нет, будут автоматически созданы. Атрибут labels не поддерживается при использовании с платформой ND. См. коллекцию ND для полного управления сайтом.
location словарь	Местоположение сайта. Атрибут location не поддерживается при использовании с платформой ND. См. коллекцию ND для полного управления сайтом.
latitude число с плавающей точкой	Широта местоположения сайта.
longitude число с плавающей точкой	Долгота местоположения сайта.
login_domain строка	Имя домена входа для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_LOGIN_DOMAIN` При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использовано значение переменной инвентаризации `ansible_httpapi_login_domain`
output_level строка	Влияет на вывод модуля MSO. `normal` означает стандартный вывод, в т.ч. `current` словарь `info` добавляет информативный вывод, в т.ч. `previous`, `proposed` и `sent` словари `debug` добавляет отладочный вывод, в т.ч. `filter_string`, `method`, `response`, `status` и `url` информация Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_OUTPUT_LEVEL` Варианты: `"debug"` `"info"` `"normal"` ← (по умолчанию)
password строка	Пароль для аутентификации. Если значение не указано в задаче, вместо него будут использованы значения переменных среды `MSO_PASSWORD` или `ANSIBLE_NET_PASSWORD`
port целое число	Номер порта для подключения REST. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_PORT`
site псевдонимы: name строка	Имя сайта.
state строка	Используйте `present` или `absent` для добавления или удаления. Используйте `query` для отображения объекта или нескольких объектов. Варианты: `"absent"` `"present"` ← (по умолчанию) `"query"`
timeout целое число	Таймаут уровня сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_TIMEOUT`
urls список / элементы=строка	Список URL-адресов, ссылающихся на APIC. Атрибут urls не поддерживается при использовании с платформой ND. См. коллекцию ND для полного управления сайтом.
use_proxy логическое значение	Если `false`, прокси не будет использоваться, даже если он определён в переменной окружения на целевых хостах. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_USE_PROXY` По умолчанию `true` Варианты: `false` `true`

END_OF_DOCUMENT_MARKER

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`

Примечания

Примечание

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

Примеры

- name: Add a new site
  cisco.mso.mso_site:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    site: north_europe
    description: North European Datacenter
    apic_username: mso_admin
    apic_password: AnotherSecretPassword
    apic_site_id: 12
    urls:
      - 10.2.3.4
      - 10.2.4.5
      - 10.3.5.6
    labels:
      - NEDC
      - Europe
      - Diegem
    location:
      latitude: 50.887318
      longitude: 4.447084
    state: present

- name: Remove a site
  cisco.mso.mso_site:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    site: north_europe
    state: absent

- name: Query a site
  cisco.mso.mso_site:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    site: north_europe
    state: query
  register: query_result

- name: Query all sites
  cisco.mso.mso_site:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    state: query
  register: query_result

Авторы

Dag Wieers (@dagwieers)

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

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/mso/mso_site_module.html