Модуль cisco.mso.mso_schema_site_l3out – Управление локальными по слою 3 исходящими соединениями (L3Outs) в шаблоне схемы

Примечание

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

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

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

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

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

Описание

Управление локальными соединениями L3Outs в шаблоне схемы на Cisco ACI Multi-Site.
Этот модуль может быть использован только с версиями MSO 3.0 или выше.
ПРИМЕЧАНИЕ – Использование этого модуля для версий MSO ниже 3.0 может привести к ошибкам в работе MSO.

Требования

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

Multi Site Orchestrator версии 2.1 или выше

Параметры

Параметр	Комментарии
host псевдонимы: hostname строка	IP-адрес или имя хоста хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, будет использовано значение переменной среды `MSO_HOST`.
l3out псевдонимы: имя строка	Имя l3out для управления.
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` при использовании традиционного метода подключения (только для mso). Варианты: `false` `true`
username строка	Имя пользователя для аутентификации. Если значение не указано в задаче, будут использованы значения переменных среды `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
validate_certs булево	Если `false`, сертификаты SSL не будут проверены. Это следует установить в `false` только при использовании на сайтах с собственными сертификатами. Если значение не указано в задаче, будет использовано значение переменной среды `MSO_VALIDATE_CERTS`. Значение по умолчанию — `true`. Варианты: `false` `true`
vrf словарь	VRF, связанный с этим L3out.
name строка / обязательно	Имя VRF для ассоциации.

схема строка	Схема, определяющая сопоставленную ВРФ. Если этот параметр не указан, используется текущая схема по умолчанию.
шаблон строка	Шаблон, определяющий сопоставленную ВРФ. Если этот параметр не указан, используется текущая схема по умолчанию.

Примечания

Примечание

Этот модуль был разработан для поддержки Multi Site Orchestrator версии 2.1 или выше. Некоторые или все функции могут не работать в более ранних версиях.

См. также

cisco.mso.mso_schema_site: Управление сайтами в схемах.
cisco.mso.mso_schema_template_l3out: Управление l3out в шаблонах схем.

Примеры

- name: Add a new site L3Out
  cisco.mso.mso_schema_site_l3out:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    l3out: L3out1
    vrf:
      name: vrfName
      template: TemplateName
      schema: schemaName
    state: present

- name: Remove a site L3Out
  cisco.mso.mso_schema_site_l3out:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    l3out: L3out1
    state: absent

- name: Query a specific site L3Out
  cisco.mso.mso_schema_site_l3out:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    l3out: L3out1
    state: query
  register: query_result

- name: Query all site l3outs
  cisco.mso.mso_schema_site_l3out:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    state: query
  register: query_result

Авторы

Anvitha Jain (@anvitha-jain)

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

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