cisco.mso.mso_schema_site_anp_epg_useg_attribute модуль — Управление атрибутами uSeg сайта EPG в схеме сайтов

Примечание

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

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

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

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

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

Управление атрибутами сайта uSeg в схеме сайтов EPG на Cisco ACI Multi-Site.

Требования

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

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

Параметры

Параметр	Комментарии
anp строка / обязательно	Имя профиля приложения.
description псевдонимы: descr строка	Описание атрибута uSeg.
epg строка / обязательно	Имя EPG.
host псевдонимы: hostname строка	IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, будет использовано значение переменной среды `MSO_HOST`.
login_domain строка	Имя домена входа для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, будет использовано значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании плагина подключения HTTPAPI в случае, если этот атрибут не указан, будет использована переменная инвентаризации `ansible_httpapi_login_domain`.
name псевдонимы: useg строка	Имя и отображаемое имя атрибута uSeg.
operator строка	Тип оператора атрибута uSeg. Варианты: `"equals"` `"contains"` `"starts_with"` `"ends_with"`
output_level строка	Влияет на вывод этого модуля MSO. `normal` — стандартный вывод, включая `current` dict `info` добавляет информационный вывод, включая `previous`, `proposed` и `sent` dicts `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 строка / обязательно	Имя схемы.
site строка / обязательно	Имя сайта.
state строка	Используйте `present` или `absent` для добавления или удаления. Используйте `query` для вывода объекта или нескольких объектов. Варианты: `"absent"` `"present"` ← (по умолчанию) `"query"`
template строка / обязательно	Имя шаблона.
timeout целое число	Таймаут уровня сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, будет использовано значение переменной среды `MSO_TIMEOUT`.
type псевдонимы: attribute_type строка	Тип атрибута uSeg. Варианты: `"vm_name"` `"ip"` `"mac"` `"vmm_domain"` `"vm_operating_system"` `"vm_tag"` `"vm_hypervisor_identifier"` `"dns"` `"vm_datacenter"` `"vm_identifier"` `"vnic_dn"`
use_proxy логическое	Если `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`
useg_subnet boolean	Подсеть uSeg может быть использована только при attribute_type равном IP. Используйте `false`, чтобы установить пользовательский IP-адрес подсети uSeg для атрибута uSeg. Используйте `true`, чтобы установить стандартный IP-адрес подсети uSeg 0.0.0.0. Варианты: `false` `true`
username string	Имя пользователя для аутентификации. Если значение не указано в задаче, будет использовано значение переменных среды `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
validate_certs boolean	Если `false`, сертификаты SSL не будут проверены. Это следует установить в `false` только при использовании на сайтах с собственными самоподписанными сертификатами. Если значение не указано в задаче, будет использовано значение переменной среды `MSO_VALIDATE_CERTS`. По умолчанию `true`. Варианты: `false` `true`
value aliases: attribute_value string	Значение атрибута uSeg.

Примечания

Примечание

Из-за ограничений MSO REST API одновременные изменения в подсетях EPG могут быть опасны и привести к повреждению данных.
Этот модуль был разработан для поддержки Multi Site Orchestrator v2.1 или более поздних версий. Некоторые или все функции могут не работать на более ранних версиях.

Примеры

- name: Add an uSeg attr with attribute_type - ip
  cisco.mso.mso_schema_site_anp_epg_useg_attribute:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    anp: ANP 1
    epg: EPG 1
    site: ansible_test
    name: useg_attr_ip
    attribute_type: ip
    useg_subnet: false
    value: 10.0.0.0/24
    state: present

- name: Query a specific EPG uSeg attr with name
  cisco.mso.mso_schema_site_anp_epg_useg_attribute:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    anp: ANP 1
    epg: EPG 1
    name: useg_attr_ip
    site: ansible_test
    state: query
  register: query_result

- name: Query all EPG uSeg attrs
  cisco.mso.mso_schema_site_anp_epg_useg_attribute:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    anp: ANP 1
    epg: EPG 1
    site: ansible_test
    state: query
  register: query_result

- name: Remove a uSeg attr from an EPG with name
  cisco.mso.mso_schema_site_anp_epg_useg_attribute:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    anp: ANP 1
    epg: EPG 1
    site: ansible_test
    name: useg_attr_ip
    state: absent

Авторы

Sabari Jaganathan (@sajagana)

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

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