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

Примечание

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

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

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

Для использования в playbook укажите: 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`

END_OF_DOCUMENT_MARKER

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 ACI MultiSite PATCH имеет недостаток, требующий, чтобы некоторые объекты ссылались по индексу. Это может привести к неявной порче при одновременном доступе при изменении/удалении объекта, так как может быть обращение к неправильному объекту. Этот модуль подвержен этому недостатку.
Этот модуль был разработан для поддержки Multi Site Orchestrator v2.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–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_anp_epg_subnet_module.html