cisco.mso.mso_schema_site_vrf_region_cidr module – Управление локальными для сайта CIDR-диапазонами регионов VRF в шаблоне схемы

Примечание

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

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

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

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

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

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

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

Требования

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

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

Параметры

Параметр	Комментарии
cidr псевдонимы: ip string	Имя CIDR-диапазона региона для управления.
host псевдонимы: hostname string	IP-адрес или имя хоста узла ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_HOST`.
login_domain string	Имя домена входа, используемое для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_LOGIN_DOMAIN`. При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использована переменная инвентаря `ansible_httpapi_login_domain`.
output_level string	Определяет состав выходных данных этого модуля MSO. `normal` означает стандартный вывод, в том числе словарь `current` `info` добавляет информационный вывод, в том числе `previous`, `proposed` и словари `sent` `debug` добавляет отладочный вывод, в том числе сведения `filter_string`, `method`, `response`, `status` и `url` Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_OUTPUT_LEVEL`. Варианты: `"debug"` `"info"` `"normal"` ← (по умолчанию)
password string	Пароль, используемый для аутентификации. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_PASSWORD` или `ANSIBLE_NET_PASSWORD`.
port integer	Номер порта для REST-подключения. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_PORT`.
primary boolean	Является ли этот CIDR-диапазон основным. Варианты: `false` `true` ← (по умолчанию)
region string / обязательный	Имя региона.
schema string / обязательный	Имя схемы.
site string / обязательный	Имя сайта.
state string	Используйте `present` или `absent` для добавления или удаления. Используйте `query` для вывода одного или нескольких объектов. Варианты: `"absent"` `"present"` ← (по умолчанию) `"query"`
template string / обязательный	Имя шаблона.
timeout integer	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_TIMEOUT`.
use_proxy boolean	Если `false`, прокси использоваться не будет, даже если он указан в переменной окружения на целевых хостах. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_USE_PROXY`. Значение по умолчанию — `true`. Варианты: `false` `true`
use_ssl boolean	Если `false`, вместо HTTPS-подключения, используемого по умолчанию, будет применяться HTTP-подключение. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `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`
vrf string / обязательный	Имя VRF.

Примечания

Примечание

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

См. также

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

Примеры

- name: Add a new site VRF region CIDR
  cisco.mso.mso_schema_site_vrf_region_cidr:
    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: present

- name: Remove a site VRF region CIDR
  cisco.mso.mso_schema_site_vrf_region_cidr:
    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: absent

- name: Query a specific site VRF region CIDR
  cisco.mso.mso_schema_site_vrf_region_cidr:
    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

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

Авторы

Dag Wieers (@dagwieers)
Lionel Hercot (@lhercot)

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

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