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

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: cisco.mso.mso_schema_site_anp_epg_subnet.

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

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

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

Требования

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

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

Параметры

Параметр	Описание
anp строка / обязательный	Имя ANP.
description строка	Описание этой подсети.
epg строка / обязательный	Имя EPG.
host псевдонимы: hostname строка	IP-адрес или имя узла ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_HOST`.
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`.
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`. Значение по умолчанию — `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`

Примечания

Примечание

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

См. также

cisco.mso.mso_schema_site_anp_epg: Управление локальными для сайта группами конечных точек (EPG) в шаблоне схемы.
cisco.mso.mso_schema_template_anp_epg_subnet: Управление подсетями EPG в шаблонах схем.

Примеры

- name: Add a new subnet to a site EPG
  cisco.mso.mso_schema_site_anp_epg_subnet:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    subnet: 10.0.0.0/24
    state: present

- name: Remove a subnet from a site EPG
  cisco.mso.mso_schema_site_anp_epg_subnet:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    subnet: 10.0.0.0/24
    state: absent

- name: Query a specific site EPG subnet
  cisco.mso.mso_schema_site_anp_epg_subnet:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    subnet: 10.0.0.0/24
    state: query
  register: query_result

- name: Query all site EPG subnets
  cisco.mso.mso_schema_site_anp_epg_subnet:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    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_anp_epg_subnet_module.html