модуль cisco.mso.mso_schema_site_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_site_external_epg.

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

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

Управление внешней EPG в схеме сайтов Cisco ACI Multi-Site.
Этот модуль можно использовать только в MSO версии 3.3 или более поздней.

Требования

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

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

Параметры

Параметр	Комментарии
external_epg псевдонимы: name строка	Имя внешней EPG, которой нужно управлять.
host псевдонимы: hostname строка	IP-адрес или имя хоста Cisco ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_HOST`.
l3out псевдонимы: l3out_name строка	L3Out, связанная с внешней EPG. Обязательный параметр, если тип сайта — on-premise. В версиях NDO выше 4.2 этот параметр доступен только в том случае, если внешняя EPG связана с VRF текущего шаблона схемы.
l3out_on_apic логическое значение	Если этот параметр указан, созданная ссылка на l3out будет указывать на различающееся имя (DN) в APIC. Варианты: `false` `true`
l3out_schema строка	Схема, в которой определена указанная L3Out. Если этот параметр не задан, по умолчанию используется текущая схема.
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`.
route_reachability строка	Определяет, указывает ли маршрут внешней EPG на Интернет или внешнюю удаленную сеть. Доступен только при связи с сайтом Azure. Варианты: `"internet"` ← (по умолчанию) `"site-ext"`
schema строка / обязательный	Имя схемы.
site строка / обязательный	Имя сайта.
state строка	Для добавления или удаления используйте `present` или `absent`. Для получения списка одного или нескольких объектов используйте `query`. Варианты: `"absent"` `"present"` ← (по умолчанию) `"query"`
template строка / обязательный	Имя шаблона, который нужно изменить.
timeout целое число	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_TIMEOUT`.
use_proxy логическое значение	Если `false`, прокси использоваться не будет, даже если он задан в переменной среды на целевых хостах. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_USE_PROXY`. По умолчанию используется `true`. Варианты: `false` `true`
use_ssl логическое значение	Если `false`, вместо подключения HTTPS, используемого по умолчанию, будет установлено подключение HTTP. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_USE_SSL`. При использовании подключаемого модуля соединения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаря `ansible_httpapi_use_ssl`. При использовании подключаемого модуля соединения HTTPAPI (mso или nd) по умолчанию используется `false`, а при использовании устаревшего метода подключения (только для mso) — `true`. Варианты: `false` `true`
username строка	Имя пользователя, используемое для аутентификации. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
validate_certs логическое значение	Если `false`, проверка SSL-сертификатов выполняться не будет. Устанавливайте значение `false` только на контролируемых вами сайтах, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_VALIDATE_CERTS`. По умолчанию используется `true`. Варианты: `false` `true`

Примечания

Примечание

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

См. также

cisco.mso.mso_schema_template_external_epg: Управление внешними EPG в шаблонах схем.

Примеры

- name: Add a Site External EPG
  cisco.mso.mso_schema_site_external_epg:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    external_epg: External EPG 1
    l3out: L3out1
    state: present

- name: Remove a Site External EPG
  cisco.mso.mso_schema_site_external_epg:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    external_epg: External EPG 1
    l3out: L3out1
    state: absent

- name: Query a Site External EPG
  cisco.mso.mso_schema_site_external_epg:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    external_epg: External EPG 1
    l3out: L3out1
    state: query
  register: query_result

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

Авторы

Anvitha Jain (@anvitha-jain)

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

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