Модуль cisco.mso.mso_schema_template_external_epg — управление внешними EPG в шаблонах схем

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: cisco.mso.mso_schema_template_external_epg.

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

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

Управление внешними EPG в шаблонах схем в Cisco ACI Multi-Site.

Псевдонимы: mso_schema_template_externalepg

Требования

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

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

Параметры

Параметр	Комментарии
anp словарь	ANP, связанный с внешним EPG.
name строка / обязательный	Имя ANP, с которым нужно связать.
schema строка	Схема, определяющая указанную ANP. Если параметр не задан, используется текущая схема.
template строка	Шаблон, определяющий указанную ANP. Если параметр не задан, используется текущий шаблон.
description строка	Описание внешнего EPG поддерживается в версиях MSO 3.3 и новее.
display_name строка	Имя, отображаемое в веб-интерфейсе MSO.
external_epg псевдонимы: name, externalepg строка	Имя внешнего EPG, которым нужно управлять.
host псевдонимы: hostname строка	IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него используется значение переменной окружения `MSO_HOST`.
l3out словарь	L3Out, связанный с внешним EPG.
name строка / обязательный	Имя L3Out, с которым нужно связать.
schema строка	Схема, определяющая указанную L3Out. Если параметр не задан, используется текущая схема.
template строка	Шаблон, определяющий указанную L3Out. Если параметр не задан, используется текущий шаблон.
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`.
preferred_group логическое значение	Указывает, включена ли группа Preferred Group для этого внешнего EPG. Варианты: `false` `true`
qos_level строка	Параметр QoS Level поддерживается в версиях MSO/NDO 4.3 и новее. Если при создании значение не задано, используется `unspecified`. Варианты: `"unspecified"` `"level1"` `"level2"` `"level3"` `"level4"` `"level5"` `"level6"`
schema строка / обязательный	Имя схемы.
state строка	Для добавления или удаления используйте `present` или `absent`. Для получения списка одного или нескольких объектов используйте `query`. Варианты: `"absent"` `"present"` ← (по умолчанию) `"query"`
template строка / обязательный	Имя шаблона.
timeout целое число	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него используется значение переменной окружения `MSO_TIMEOUT`.
type строка	Тип внешнего EPG. Если тип — cloud, с внешним EPG необходимо связать ANP. Если тип — on-premise, с внешним EPG можно связать L3Out. Варианты: `"on-premise"` ← (по умолчанию) `"cloud"`
use_proxy логическое значение	Если задано `false`, прокси использоваться не будет, даже если он задан в переменной окружения на целевых хостах. Если значение не указано в задаче, вместо него используется значение переменной окружения `MSO_USE_PROXY`. По умолчанию используется `true`. Варианты: `false` `true`
use_ssl логическое значение	Если задано `false`, вместо HTTPS-подключения по умолчанию будет использоваться HTTP-подключение. Если значение не указано в задаче, вместо него используется значение переменной окружения `MSO_USE_SSL`. При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаризации `ansible_httpapi_use_ssl`. По умолчанию используется `false` при работе с плагином подключения HTTPAPI (mso или nd) и `true` при использовании устаревшего метода подключения (только для mso). Варианты: `false` `true`
username строка	Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него используется значение переменной окружения `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
validate_certs логическое значение	Если задано `false`, сертификаты SSL проверяться не будут. Значение `false` следует задавать только для сайтов под личным контролем, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него используется значение переменной окружения `MSO_VALIDATE_CERTS`. По умолчанию используется `true`. Варианты: `false` `true`
vrf словарь	VRF, связанный с внешним EPG.
name строка / обязательный	Имя VRF, с которым нужно связать.
schema строка	Схема, определяющая указанную VRF. Если параметр не задан, используется текущая схема.
template строка	Шаблон, определяющий указанную VRF. Если параметр не задан, используется текущий шаблон.

Примечания

Примечание

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

Примеры

- name: Add a new external EPG
  cisco.mso.mso_schema_template_external_epg:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    external_epg: External EPG 1
    vrf:
      name: VRF
      schema: Schema 1
      template: Template 1
    state: present

- name: Add a new external EPG with external epg in cloud
  cisco.mso.mso_schema_template_external_epg:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    external_epg: External EPG 1
    type: cloud
    vrf:
      name: VRF
      schema: Schema 1
      template: Template 1
    anp:
      name: ANP1
      schema: Schema 1
      template: Template 1
    state: present

- name: Remove an external EPG
  cisco.mso.mso_schema_template_external_epg:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    external_epg: external EPG1
    state: absent

- name: Query a specific external EPGs
  cisco.mso.mso_schema_template_external_epg:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    external_epg: external EPG1
    state: query
  register: query_result

- name: Query all external EPGs
  cisco.mso.mso_schema_template_external_epg:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    state: query
  register: query_result

Авторы

Dag Wieers (@dagwieers)

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

© 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/mso_schema_template_external_epg_module.html