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

Примечание

Этот модуль входит в коллекцию cisco.mso (версия 2.9.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 v2.1 или новее

Параметры

Параметр	Комментарии
anp dictionary	anp, связанный с внешним epg.
name string / required	Имя anp для связи.
schema string	Схема, определяющая ссылающийся anp. Если этот параметр не указан, по умолчанию используется текущая схема.
template string	Шаблон, определяющий ссылающийся anp. Если этот параметр не указан, по умолчанию используется текущий шаблон.
description string	Описание внешнего EPG поддерживается на версиях MSO 3.3 и выше.
display_name string	Имя, отображаемое в веб-интерфейсе MSO.
external_epg aliases: name, externalepg string	Имя внешнего EPG для управления.
host aliases: hostname string	IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_HOST`.
l3out dictionary	L3Out, связанный с внешним epg.
name string / required	Имя L3Out для связи.
schema string	Схема, определяющая ссылающийся L3Out. Если этот параметр не указан, по умолчанию используется текущая схема.
template string	Шаблон, определяющий ссылающийся L3Out. Если этот параметр не указан, по умолчанию используется текущий шаблон.
login_domain string	Имя домена входа для аутентификации. Значение по умолчанию - Local. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании подключаемого модуля HTTPAPI будет использоваться переменная инвентаризации `ansible_httpapi_login_domain`, если этот атрибут не указан.
output_level string	Влияет на вывод этого модуля MSO. `normal` означает стандартный вывод, включая `current` dict `info` добавляет информационный вывод, включая `previous`, `proposed` и `sent` dicts `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`.
preferred_group boolean	Включена ли предпочтительная группа для этого внешнего EPG или нет. Варианты: `false` `true`
schema string / required	Имя схемы.
state string	Используйте `present` или `absent` для добавления или удаления. Используйте `query` для перечисления одного или нескольких объектов. Варианты: `"absent"` `"present"` ← (по умолчанию) `"query"`
template string / required	Имя шаблона.

timeout целое число	Тайм-аут уровня сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, будет использовано значение переменной окружения `MSO_TIMEOUT`.
type строка	Тип внешнего epg. anp необходимо связать с внешним epg, когда тип — облачный. l3out можно связать с внешним epg, когда тип — локальный. Варианты: `"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 v2.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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/mso/mso_schema_template_external_epg_module.html