Модуль cisco.mso.mso_schema_site_vrf_region_hub_network — Управление локальной для сайта VRF областью концентратора сети в шаблоне схемы

Примечание

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

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

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

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

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

Обзор

Управление локальной для сайта VRF областью концентратора сети в шаблоне схемы на Cisco ACI Multi-Site.
Функция «Сеть концентратора» была добавлена в Multi-Site Orchestrator (MSO) версии 3.0(1) для AWS и версии 3.0(2) для Azure.

Требования

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

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

END_OF_DOCUMENT_MARKER

Параметры

Параметр	Комментарии
host псевдонимы: hostname строка	IP-адрес или имя хоста хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_HOST`.
hub_network словарь	Управляемая сеть хаба.
name строка / обязательно	Имя сети хаба. hub-default — это сеть хаба по умолчанию, созданная по умолчанию.
tenant строка / обязательно	Имя клиента сети хаба.
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`.
region строка / обязательно	Название региона.
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

boolean

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

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

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

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

Варианты:

false
true

vrf

string / обязательно

Имя VRF.

Примечания

Примечание

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

См. также

cisco.mso.mso_schema_site_vrf_region: Управление локальными для сайта областями VRF в шаблоне схемы.
cisco.mso.mso_schema_template_vrf: Управление VRF в шаблонах схемы.

Примеры

- name: Add a new site VRF region hub network
  cisco.mso.mso_schema_site_vrf_region_hub_network:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    vrf: VRF1
    region: us-west-1
    hub_network:
      name: hub-default
      tenant: infra
    state: present

- name: Remove a site VRF region hub network
  cisco.mso.mso_schema_site_vrf_region_hub_network:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    vrf: VRF1
    state: absent

- name: Query site VRF region hub network
  cisco.mso.mso_schema_site_vrf_region_hub_network:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    vrf: VRF1
    region: us-west-1
    state: query
  register: query_result

Авторы

Cindy Zhao (@cizhao)

Ссылки на сборку

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