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

Примечание

Этот модуль входит в коллекцию cisco.mso (версия 2.13.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 версии 2.1 или новее

Параметры

Параметр	Комментарии
bd псевдонимы: name строка / обязательный	Имя BD.
description строка	Описание этой подсети.
host псевдонимы: hostname строка	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` `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`.
primary логическое значение	Считать основной подсетью. Для каждого семейства адресов в рамках BD может быть только одна основная подсеть. Этот параметр доступен только в MSO версии 3.1.1h или новее. Варианты: `false` ← (по умолчанию) `true`
querier логическое значение	Является ли эта подсеть IGMP-запросчиком. Варианты: `false` ← (по умолчанию) `true`
schema строка / обязательный	Имя схемы.
scope строка	Область действия подсети. Варианты: `"private"` `"public"`
shared логическое значение	Используется ли эта подсеть совместно несколькими VRF. Варианты: `false` ← (по умолчанию) `true`
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`. При использовании плагина подключения 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`

Примечания

Примечание

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

См. также

cisco.mso.mso_schema_site_bd: Управление локальными для сайта доменами Bridge (BD) в шаблоне схемы.
cisco.mso.mso_schema_template_bd: Управление доменами Bridge (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–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_bd_subnet_module.html