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

Примечание

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

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

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

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

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

Описание

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

Требования

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

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

Параметры

Параметр	Комментарии
bd псевдонимы: имя строка / обязательно	Название БД.
host псевдонимы: имя_хоста строка	IP-адрес или имя хоста хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, используется значение переменной окружения `MSO_HOST`.
l3out словарь	l3out, связанный с этой БД.
name строка / обязательно	Имя l3out для ассоциации.
schema строка	Схема, которая определяет связанный l3out. Если этот параметр не указан, используется текущая схема. Взаимоисключающий с `l3out.tenant`.
template строка	Шаблон, который определяет связанный l3out. Если этот параметр не указан, используется текущая схема. Взаимоисключающий с `l3out.tenant`.
tenant строка	Имя арендатора связанного l3out. Если этот параметр указан, сконструированная ссылка l3out будет ссылаться на отличительное имя (DN) в APIC. Взаимоисключающий с `l3out.schema` и `l3out.template`.
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`.
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` будет использоваться, если этот атрибут не указан. По умолчанию `false` при использовании плагина HTTPAPI подключения (mso или nd) и `true` при использовании метода подключения legacy (только для mso). Варианты: `false` `true`

логин

строка

Имя пользователя для аутентификации.

Если значение не указано в задаче, будет использовано значение переменных среды MSO_USERNAME или ANSIBLE_NET_USERNAME.

validate_certs

булево

Если false, сертификаты SSL не будут проверены.

Это следует устанавливать в false только при использовании на сайтах под собственным контролем с использованием самозаверенных сертификатов.

Если значение не указано в задаче, будет использовано значение переменной среды MSO_VALIDATE_CERTS.

По умолчанию true.

Варианты:

false
true

Примечания

Примечание

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

См. также

cisco.mso.mso_schema_site_bd: Управление локальными областями мостов (BD) в шаблоне схемы.
cisco.mso.mso_schema_template_bd: Управление областями мостов (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:
      name: L3out1
    state: present

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

- 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:
      name: L3out1
    state: absent

- 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:
      name: L3out1
    state: query
  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
  register: query_result

Авторы

Dag Wieers (@dagwieers)
Anvitha Jain (@anvitha-jain)
Akini Ross (@akinross)

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

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