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

Примечание

Этот модуль входит в состав коллекции cisco.mso (версия 2.13.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.
Функция «Hub Network» появилась в Multi-Site Orchestrator (MSO) версии 3.0(1) для AWS и версии 3.0(2) для Azure.

Требования

На узле, выполняющем этот модуль, необходимы следующие компоненты.

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

Параметры

Параметр	Комментарии
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`. При использовании подключаемого модуля подключения HTTPAPI (mso или nd) значение по умолчанию — `false`, а при использовании устаревшего метода подключения (только для mso) — `true`. Варианты: `false` `true`
username строка	Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
validate_certs логическое значение	Если `false`, проверка SSL-сертификатов выполняться не будет. Значение `false` следует задавать только для сайтов под личным контролем, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_VALIDATE_CERTS`. Значение по умолчанию — `true`. Варианты: `false` `true`
vrf строка / обязательный	Имя VRF.

Примечания

Примечание

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