Модуль cisco.mso.mso_schema_site_bd_subnet – Управление подсетями BD локального сайта в шаблоне схемы

Примечание

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

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

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

Чтобы использовать его в книге задач, укажите: cisco.mso.mso_schema_site_bd_subnet.

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

Краткое описание

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

Требования

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

Multi Site Orchestrator v2.1 или более поздней версии

Параметры

Параметр	Комментарии
bd псевдонимы: name строка / обязательный	Имя BD.
описание строка	Описание подсети.
хост псевдонимы: имя_хоста строка	IP-адрес или имя хоста хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, используется значение переменной окружения `MSO_HOST`.
is_virtual_ip логическое	Обрабатывать как виртуальный IP-адрес Выбори: `false` ← (по умолчанию) `true`
login_domain строка	Имя домена входа для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, используется значение переменной окружения `MSO_LOGIN_DOMAIN`. При использовании плагина подключения HTTPAPI будет использоваться переменная инвентаризации `ansible_httpapi_login_domain`, если этот атрибут не указан.
no_default_gateway логическое	Наличие шлюза по умолчанию для этой подсети. Выбори: `false` ← (по умолчанию) `true`
output_level строка	Влияние на вывод данного модуля MSO. `normal` означает стандартный вывод, вкл. `current` dict `info` добавляет информационный вывод, вкл. `previous`, `proposed` и `sent` dicts `debug` добавляет отладочный вывод, вкл. `filter_string`, `method`, `response`, `status` и `url` информацию Если значение не указано в задаче, используется значение переменной окружения `MSO_OUTPUT_LEVEL`. Выбори: `"debug"` `"info"` `"normal"` ← (по умолчанию)
пароль строка	Пароль для аутентификации. Если значение не указано в задаче, используются значения переменных окружения `MSO_PASSWORD` или `ANSIBLE_NET_PASSWORD`.
порт целое число	Порт для REST-соединения. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, используется значение переменной окружения `MSO_PORT`.
primary логическое	Обрабатывать как основную подсеть. В рамках BD может быть только одна основная подсеть на семейство адресов. Данный параметр может быть использован только на версиях MSO 3.1.1h и выше. Выбори: `false` ← (по умолчанию) `true`
querier логическое	Является ли эта подсеть IGMP-запрашивателем. Выбори: `false` ← (по умолчанию) `true`
схема строка / обязательный	Имя схемы.
scope строка	Область подсети. Выбори: `"private"` `"public"`
shared логическое	Является ли эта подсеть общей для VRF. Выбори: `false` ← (по умолчанию) `true`
сайт строка / обязательный	Имя сайта.
состояние строка	Используйте `present` или `absent` для добавления или удаления. Используйте `query` для отображения объекта или нескольких объектов. Выбори: `"absent"` `"present"` ← (по умолчанию) `"query"`
подсеть псевдонимы: ip строка	Диапазон IP-адресов в CIDR-нотации.
шаблон строка / обязательный	Имя шаблона.

timeout integer	Время ожидания на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, будет использовано значение переменной среды `MSO_TIMEOUT`.
use_proxy boolean	Если `false`, прокси не будет использоваться, даже если он определен в переменной среды на целевых хостах. Если значение не указано в задаче, будет использовано значение переменной среды `MSO_USE_PROXY`. Значение по умолчанию — `true`. Варианты: `false` `true`
use_ssl boolean	Если `false`, будет использоваться HTTP-соединение вместо стандартного HTTPS-соединения. Если значение не указано в задаче, будет использовано значение переменной среды `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 subnet
  cisco.mso.mso_schema_site_bd_subnet:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    bd: BD1
    subnet: 11.11.11.0/24
    state: present

- name: Remove a site BD subnet
  cisco.mso.mso_schema_site_bd_subnet:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    bd: BD1
    subnet: 11.11.11.0/24
    state: absent

- name: Query a specific site BD subnet
  cisco.mso.mso_schema_site_bd_subnet:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    bd: BD1
    subnet: 11.11.11.0/24
    state: query
  register: query_result

- name: Query all site BD subnets
  cisco.mso.mso_schema_site_bd_subnet:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    bd: BD1
    state: query
  register: query_result

Авторы

Dag Wieers (@dagwieers)

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

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