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

Примечание

Этот плагин является частью коллекции cisco.mso (версия 1.1.0).

Для его установки используйте: ansible-galaxy collection install cisco.mso.

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

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

Обзор

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

Требования

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

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
anp словарь			Ассоциированный с внешним epg anp.
	name строка / обязательно		Имя anp для ассоциации.
	schema строка		Схема, определяющая ссылку anp. Если этот параметр не указан, он устанавливается по умолчанию в текущую схему.
	template строка		Шаблон, определяющий ссылку anp. Если этот параметр не указан, он устанавливается по умолчанию в текущий шаблон.
display_name строка			Имя, отображаемое на веб-интерфейсе MSO.
external_epg строка			Имя внешнего EPG для управления. псевдонимы: name, externalepg
host строка / обязательно			IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_HOST`. псевдонимы: hostname
l3out словарь			Связанный с внешним epg L3Out.
	name строка / обязательно		Имя L3Out для ассоциации.
	schema строка		Схема, определяющая ссылку L3Out. Если этот параметр не указан, он устанавливается по умолчанию в текущую схему.
	template строка		Шаблон, определяющий ссылку L3Out. Если этот параметр не указан, он устанавливается по умолчанию в текущий шаблон.
login_domain строка			Имя домена входа для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_LOGIN_DOMAIN`.
output_level строка		Варианты: debug info normal ←	Влияет на вывод этого модуля ACI. `normal` означает стандартный вывод, включая `current` словарь `info` добавляет информативный вывод, включая `previous`, `proposed` и `sent` словари `debug` добавляет отладочный вывод, включая `filter_string`, `method`, `response`, `status` и `url` информацию Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_OUTPUT_LEVEL`.
password строка / обязательно			Пароль для аутентификации. Если значение не указано в задаче, вместо него будут использованы переменные окружения `MSO_PASSWORD` или `ANSIBLE_NET_PASSWORD`.
port целое число			Порт, используемый для подключения REST. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_PORT`.
preferred_group логическое		Варианты: no yes	Включена ли функция Preferred Group для этого внешнего EPG.
schema строка / обязательно			Имя схемы.
state строка		Варианты: absent present ← query	Используйте `present` или `absent` для добавления или удаления. Используйте `query` для перечисления объекта или нескольких объектов.
template строка / обязательно			Имя шаблона.
timeout целое число		По умолчанию: 30	Таймаут уровня сокета в секундах. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_TIMEOUT`.
type строка		Варианты: on-premise ← cloud	Тип внешнего epg. anp должен быть связан с внешним epg, когда тип — cloud. l3out может быть связан с внешним epg, когда тип — on-premise.
use_proxy логическое		Варианты: no yes ←	Если `no`, прокси не будет использоваться, даже если он определен в переменной окружения на целевых хостах. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_USE_PROXY`.
use_ssl логическое		Варианты: no yes ←	Если `no`, вместо стандартного HTTPS-подключения будет использовано HTTP-соединение. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_USE_SSL`.
username строка		По умолчанию: "admin"	Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него будут использованы переменные окружения `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
validate_certs логическое		Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Это должно быть установлено только в `no`, когда используется на сайтах с собственными сертификатами, контролируемыми лично. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_VALIDATE_CERTS`.
vrf словарь			Связанный с внешним epg VRF.
	name строка / обязательно		Имя VRF для ассоциации.
	schema строка		Схема, определяющая ссылку VRF. Если этот параметр не указан, он устанавливается по умолчанию в текущую схему.
	template строка		Шаблон, определяющий ссылку VRF. Если этот параметр не указан, он устанавливается по умолчанию в текущий шаблон.

Примечания

Примечание

Для получения более подробной информации об управлении инфраструктурой ACI с помощью Ansible, пожалуйста, обратитесь к Руководству по Cisco ACI.
Этот модуль был разработан для поддержки ACI 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
  delegate_to: localhost

- 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
  delegate_to: localhost

- 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
  delegate_to: localhost

- 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
  delegate_to: localhost
  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
  delegate_to: localhost
  register: query_result

Авторы

Dag Wieers (@dagwieers)

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