Модуль cisco.mso.mso_schema_site_vrf_region_cidr_subnet — Управление регионами 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_cidr_subnet.

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

Описание

Управление регионами VRF на локальном уровне сайта в шаблоне схемы на Cisco ACI Multi-Site.

Требования

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

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

Параметры

Параметр	Комментарии
cidr строка / обязательно	Диапазон IP-адресов для CIDR региона.
host псевдонимы: hostname строка	IP-адрес или имя хоста хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, будет использовано значение переменной среды `MSO_HOST`.
hosted_vrf строка	Имя vrf, связанного с подсетью CIDR региона. Поддерживается в версиях MSO 3.3 и выше.
login_domain строка	Имя домена входа для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, будет использовано значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использовано значение переменной инвентаризации `ansible_httpapi_login_domain`.
output_level строка	Влияет на вывод модуля MSO. `normal` означает стандартный вывод, включая `current` dict. `info` добавляет информативный вывод, включая `previous`, `proposed` и `sent` dicts. `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`.
private_link_label строка	Метка частной ссылки, используемая для представления этой подсети. Этот параметр доступен для версий MSO, больших, чем 3.3.
region строка / обязательно	Имя региона.
schema строка / обязательно	Имя схемы.
site строка / обязательно	Имя сайта.
state строка	Используйте `present` или `absent` для добавления или удаления. Используйте `query` для перечисления объекта или нескольких объектов. Варианты: `"absent"` `"present"` ← (по умолчанию) `"query"`
subnet псевдонимы: ip строка	IP-подсеть данного региона CIDR.
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`
vgw псевдонимы: hub_network логическое	Указывает, используется ли этот подсет для Azure Gateway в Azure. Указывает, используется ли этот подсет для присоединения к Transit Gateway в AWS. Варианты: `false` `true`
vrf строка / обязательно	Имя VRF.
зона псевдонимы: имя строка	Имя зоны для регионального подсети CIDR. Этот аргумент требуется для сайтов AWS.

Примечания

Примечание

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

См. также

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

Примеры

- name: Add a new site VRF region CIDR subnet
  cisco.mso.mso_schema_site_vrf_region_cidr_subnet:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    vrf: VRF1
    region: us-west-1
    cidr: 14.14.14.1/24
    subnet: 14.14.14.2/24
    zone: us-west-1a
    state: present

- name: Remove a site VRF region CIDR subnet
  cisco.mso.mso_schema_site_vrf_region_cidr_subnet:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    vrf: VRF1
    region: us-west-1
    cidr: 14.14.14.1/24
    subnet: 14.14.14.2/24
    state: absent

- name: Query a specific site VRF region CIDR subnet
  cisco.mso.mso_schema_site_vrf_region_cidr_subnet:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    vrf: VRF1
    region: us-west-1
    cidr: 14.14.14.1/24
    subnet: 14.14.14.2/24
    state: query
  register: query_result

- name: Query all site VRF region CIDR subnet
  cisco.mso.mso_schema_site_vrf_region_cidr_subnet:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    vrf: VRF1
    region: us-west-1
    cidr: 14.14.14.1/24
    state: query
  register: query_result

Авторы

Dag Wieers (@dagwieers)
Lionel Hercot (@lhercot)
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_vrf_region_cidr_subnet_module.html