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

Примечание

Этот модуль входит в коллекцию cisco.mso (версия 2.13.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 string / обязательный	Имя BD.
host псевдонимы: hostname string	IP-адрес или имя узла ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_HOST`.
l3out псевдонимы: name dictionary	l3out, связанный с этой BD.
name string / обязательный	Имя l3out, с которым нужно связать.
schema string	Схема, определяющая указанный l3out. Если этот параметр не указан, по умолчанию используется текущая схема. Несовместим с `l3out.tenant`.
template string	Шаблон, определяющий указанный l3out. Если этот параметр не указан, по умолчанию используется текущая схема. Несовместим с `l3out.tenant`.
tenant string	Имя арендатора указанного l3out. Если этот параметр указан, сформированная ссылка на l3out будет указывать на различающееся имя (DN) в APIC. Несовместим с `l3out.schema` и `l3out.template`.
login_domain string	Имя домена входа для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаризации `ansible_httpapi_login_domain`.
output_level string	Влияет на вывод этого модуля MSO. `normal` означает стандартный вывод, включая словарь `current` `info` добавляет информационный вывод, включая словари `previous`, `proposed` и `sent` `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`.
schema string / обязательный	Имя схемы.
site string / обязательный	Имя сайта.
state string	Используйте `present` или `absent` для добавления или удаления. Используйте `query` для перечисления одного или нескольких объектов. Варианты: `"absent"` `"present"` ← (по умолчанию) `"query"`
template string / обязательный	Имя шаблона.
timeout integer	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_TIMEOUT`.
use_proxy boolean	Если `false`, прокси использоваться не будет, даже если он задан в переменной среды на целевых узлах. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_USE_PROXY`. Значение по умолчанию — `true`. Варианты: `false` `true`
use_ssl boolean	Если `false`, вместо HTTPS-подключения, используемого по умолчанию, будет применяться HTTP-подключение. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_USE_SSL`. При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаризации `ansible_httpapi_use_ssl`. Значение по умолчанию — `false` при использовании плагина подключения HTTPAPI (mso или nd) и `true` при использовании устаревшего способа подключения (только для mso). Варианты: `false` `true`
username string	Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
validate_certs boolean	Если `false`, SSL-сертификаты проверяться не будут. Это значение следует устанавливать в `false` только для сайтов под личным управлением, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_VALIDATE_CERTS`. Значение по умолчанию — `true`. Варианты: `false` `true`

Примечания

Примечание

В API PATCH ACI MultiSite есть недостаток: некоторые объекты необходимо указывать по индексу. При одновременном доступе это может привести к незаметному повреждению данных во время изменения или удаления объекта, поскольку может быть указан не тот объект. Этот модуль подвержен этому недостатку.
Этот модуль создан для поддержки 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–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_bd_l3out_module.html