Модуль cisco.mso.mso_schema_site_anp_epg_domain – Управление локальными доменными 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_domain.

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

Обзор

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

Требования

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

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

Параметры

Параметр	Комментарии
allow_micro_segmentation boolean	Указывает, включена микросегментация или нет. Этот атрибут можно использовать только с ассоциацией домена VMM. Варианты: `false` `true`
allow_promiscuous string	Состояние разрешения promiscuous для ассоциации домена. Этот атрибут можно использовать только с ассоциацией домена VMM. Варианты: `"accept"` `"reject"` ← (default)
anp string / required	Имя ANP.
binding_type string	Какой тип binding_type использовать с этой ассоциацией домена. Этот атрибут можно использовать только с ассоциацией домена VMM. Варианты: `"static"` `"dynamic"` `"none"` ← (default) `"ephemeral"`
custom_epg_name string	Какое имя custom_epg_name использовать с этой ассоциацией домена. Этот атрибут можно использовать только с ассоциацией домена VMM.
delimiter string	Какой разделитель использовать с этой ассоциацией домена. Этот атрибут можно использовать только с ассоциацией домена VMM. Варианты: `"+"` `"\|"` `"~"` `"!"` `"@"` `"^"` `"="`
deployment_immediacy string	Непосредственность развертывания домена. `immediate` означает Развернуть немедленно. `lazy` означает развернуть по запросу. Варианты: `"immediate"` `"lazy"`
domain_association_type string	Тип домена для ассоциации. Варианты: `"vmmDomain"` `"l3ExtDomain"` `"l2ExtDomain"` `"physicalDomain"` `"fibreChannelDomain"`
domain_profile string	Имя профиля домена.
enhanced_lagpolicy_dn string	Отличительное имя EPG lagpolicy. Этот атрибут можно использовать только с ассоциацией домена VMM.
enhanced_lagpolicy_name string	Имя EPG enhanced lagpolicy. Этот атрибут можно использовать только с ассоциацией домена VMM.
epg string / required	Имя EPG.
forged_transmits string	Состояние forged transmits для ассоциации домена. Этот атрибут можно использовать только с ассоциацией домена VMM. Варианты: `"accept"` `"reject"` ← (default)
host aliases: hostname string	IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_HOST`.
login_domain string	Имя домена входа, используемое для аутентификации. Значение по умолчанию - Local. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_LOGIN_DOMAIN`. При использовании плагина подключения HTTPAPI будет использоваться переменная инвентаря `ansible_httpapi_login_domain`, если этот атрибут не указан.
mac_changes string	Состояние изменений MAC для ассоциации домена. Этот атрибут можно использовать только с ассоциацией домена VMM. Варианты: `"accept"` `"reject"` ← (default)
micro_seg_vlan integer	Виртуальная локальная сеть для микросегментации. Этот атрибут можно использовать только с ассоциацией домена VMM.
micro_seg_vlan_type string	Тип виртуальной локальной сети для микросегментации. Этот атрибут можно использовать только с ассоциацией домена VMM. Варианты: `"vlan"`

netflow_pref string	Состояние предпочтения NetFlow для ассоциации домена. Этот атрибут может использоваться только с ассоциацией домена VMM. Choices: `"enabled"` `"disabled"` ← (default)
num_ports integer	Количество портов для типа привязки. Этот атрибут может использоваться только с ассоциацией домена VMM.
output_level string	Влияет на вывод этого модуля MSO. `normal` означает стандартный вывод, включая `current` dict `info` добавляет информационный вывод, включая `previous`, `proposed` и `sent` dicts `debug` добавляет отладочный вывод, включая `filter_string`, `method`, `response`, `status` и `url` информацию Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_OUTPUT_LEVEL`. Choices: `"debug"` `"info"` `"normal"` ← (default)
password string	Пароль для аутентификации. Если значение не указано в задаче, вместо него будут использоваться значения переменных окружения `MSO_PASSWORD` или `ANSIBLE_NET_PASSWORD`.
port integer	Номер порта, который будет использоваться для REST-подключения. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_PORT`.
port_allocation string	Распределение портов для типа привязки. Этот атрибут может использоваться только с ассоциацией домена VMM и типом привязки в static. Обязательно, когда `binding_type=static`. Choices: `"elastic"` `"fixed"`
port_encap_vlan integer	Тип виртуальной локальной сети для инкапсуляции порта. Этот атрибут может использоваться только с ассоциацией домена VMM.
port_encap_vlan_type string	Тип виртуальной локальной сети для инкапсуляции порта. Этот атрибут может использоваться только с ассоциацией домена VMM. Choices: `"vlan"`
resolution_immediacy string	Определяет, когда политики должны быть разрешены и доступны. По умолчанию используется `lazy`, если не задано при создании. Choices: `"immediate"` `"lazy"` `"pre-provision"`
schema string / required	Имя схемы.
site string / required	Имя сайта.
state string	Используйте `present` или `absent` для добавления или удаления. Используйте `query` для перечисления одного или нескольких объектов. Choices: `"absent"` `"present"` ← (default) `"query"`
switch_type string	Какой тип коммутатора использовать с этой ассоциацией домена. Этот атрибут может использоваться только с ассоциацией домена VMM.
switching_mode string	Какой режим коммутации использовать с этой ассоциацией домена. Этот атрибут может использоваться только с ассоциацией домена VMM.
template string / required	Имя шаблона.
timeout integer	Таймаут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_TIMEOUT`.
use_proxy boolean	Если `false`, прокси использоваться не будет, даже если он определен в переменной окружения на целевых хостах. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_USE_PROXY`. Значение по умолчанию — `true`. Choices: `false` `true`

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`
vlan_encap_mode string	Режим инкапсуляции VLAN для использования. Этот атрибут может быть использован только с ассоциацией домена VMM. Варианты: `"static"` `"dynamic"`

Примечания

Примечание

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

См. также

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

Примеры

- name: Add a new domain to a site EPG
  cisco.mso.mso_schema_site_anp_epg_domain:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    domain_association_type: vmmDomain
    domain_profile: 'VMware-VMM'
    deployment_immediacy: lazy
    resolution_immediacy: pre-provision
    state: present

- name: Add a new domain to a site EPG with all possible attributes set
  cisco.mso.mso_schema_site_anp_epg_domain:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    domain_association_type: vmmDomain
    domain_profile: 'VMware-VMM'
    deployment_immediacy: immediate
    resolution_immediacy: immediate
    micro_seg_vlan_type: vlan
    micro_seg_vlan: 100
    port_encap_vlan_type: vlan
    port_encap_vlan: 100
    vlan_encap_mode: static
    allow_micro_segmentation: true
    switch_type: default
    switching_mode: native
    enhanced_lagpolicy_name: ansible_lag_name
    enhanced_lagpolicy_dn: ansible_lag_dn
    delimiter: '|'
    binding_type: static
    num_ports: 2
    port_allocation: elastic
    netflow_pref: enabled
    allow_promiscuous: accept
    forged_transmits: accept
    mac_changes: accept
    custom_epg_name: ansible_custom_epg
    state: present

- name: Query a domain associated with a specific site EPG
  cisco.mso.mso_schema_site_anp_epg_domain:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    domain_association_type: vmmDomain
    domain_profile: 'VMware-VMM'
    state: query
  register: query_result

- name: Query all domains associated with a site EPG
  cisco.mso.mso_schema_site_anp_epg_domain:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    state: query
  register: query_result

- name: Remove a domain from a site EPG
  cisco.mso.mso_schema_site_anp_epg_domain:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    domain_association_type: vmmDomain
    domain_profile: 'VMware-VMM'
    deployment_immediacy: lazy
    resolution_immediacy: pre-provision
    state: absent

Авторы

Nirav Katarmal (@nkatarmal-crest)
Mabille Florent (@fmabille09)
Akini Ross (@akinross)

Ссылки на сборку

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