cisco.mso.mso_schema_site_bd_l3out – Управление локальными BD l3out в шаблоне схемы

Примечание

Этот плагин входит в коллекцию cisco.mso (версия 1.0.1).

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

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

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

Обзор

Управление локальными BD l3out в шаблоне схемы на Cisco ACI Multi-Site.

Требования

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

Multi Site Orchestrator v2.1 или более поздней версии

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
bd строка / обязательно		Имя BD. псевдонимы: name
host строка / обязательно		IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, используется значение переменной среды `MSO_HOST`. псевдонимы: hostname
l3out строка		Имя 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`.
schema строка / обязательно		Имя схемы.
site строка / обязательно		Имя сайта.
state строка	Варианты: absent present ← query	Используйте `present` или `absent` для добавления или удаления. Используйте `query` для перечисления объекта или нескольких объектов.
template строка / обязательно		Имя шаблона.
timeout целое число	По умолчанию: 30	Таймаут уровня сокета в секундах. Если значение не указано в задаче, используется значение переменной среды `MSO_TIMEOUT`.
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`.

Примечания

Примечание

ACI MultiSite PATCH API имеет недостаток, требующий, чтобы некоторые объекты ссылались по индексу. Это может привести к молчаливой порче при одновременном доступе при изменении/удалении объекта, так как может быть обработано неверный объект. Этот модуль затронут этим недостатком.
См. Руководство Cisco ACI для получения более подробной информации о том, как управлять вашей инфраструктурой ACI с помощью Ansible.
Этот модуль был написан для поддержки ACI Multi Site Orchestrator v2.1 или более новых версий. Некоторые или все функции могут не работать на более ранних версиях.

См. также

cisco.mso.mso_schema_site_bd: Официальная документация по модулю cisco.mso.mso_schema_site_bd.
cisco.mso.mso_schema_template_bd: Официальная документация по модулю cisco.mso.mso_schema_template_bd.

Примеры

- name: Add a new site BD l3out
  cisco.mso.mso_schema_site_bd_l3out:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    bd: BD1
    l3out: L3out1
    state: present
  delegate_to: localhost

- name: Remove a site BD l3out
  cisco.mso.mso_schema_site_bd_l3out:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    bd: BD1
    l3out: L3out1
    state: absent
  delegate_to: localhost

- name: Query a specific site BD l3out
  cisco.mso.mso_schema_site_bd_l3out:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    bd: BD1
    l3out: L3out1
    state: query
  delegate_to: localhost
  register: query_result

- name: Query all site BD l3outs
  cisco.mso.mso_schema_site_bd_l3out:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    bd: BD1
    state: query
  delegate_to: localhost
  register: query_result

Авторы

Dag Wieers (@dagwieers)

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