Spec-Zone.ru › Ansible

модуль cisco.mso.mso_schema_site_anp_epg_domain — управление локальными для сайта доменами 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_domain.

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

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

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

Требования

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

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

Параметры

Параметр

Комментарии

allow_micro_segmentation

логический

Указывает, включена ли микросегментация. Этот атрибут можно использовать только для связи с доменом VMM.

Варианты:

  • false
  • true

allow_promiscuous

строка

Состояние разрешения promiscuous для связи с доменом. Этот атрибут можно использовать только для связи с доменом VMM.

Варианты:

  • "accept"
  • "reject" ← (по умолчанию)

anp

строка / обязательный

Имя ANP.

binding_type

строка

Тип привязки, используемый для этой связи с доменом. Этот атрибут можно использовать только для связи с доменом VMM.

Варианты:

  • "static"
  • "dynamic"
  • "none" ← (по умолчанию)
  • "ephemeral"

custom_epg_name

строка

Пользовательское имя EPG, используемое для этой связи с доменом. Этот атрибут можно использовать только для связи с доменом VMM.

delimiter

строка

Разделитель, используемый для этой связи с доменом. Этот атрибут можно использовать только для связи с доменом VMM.

Варианты:

  • "+"
  • "|"
  • "~"
  • "!"
  • "@"
  • "^"
  • "="

deployment_immediacy

строка

Срок развертывания домена.

immediate означает немедленное развертывание.

lazy означает развертывание по запросу.

Варианты:

  • "immediate"
  • "lazy"

domain_association_type

строка

Тип домена, с которым следует установить связь.

Варианты:

  • "vmmDomain"
  • "l3ExtDomain"
  • "l2ExtDomain"
  • "physicalDomain"
  • "fibreChannelDomain"

domain_profile

строка

Имя профиля домена.

enhanced_lagpolicy_dn

строка

Уникальное имя lagpolicy для EPG. Этот атрибут можно использовать только для связи с доменом VMM.

enhanced_lagpolicy_name

строка

Имя расширенной lagpolicy для EPG. Этот атрибут можно использовать только для связи с доменом VMM.

epg

строка / обязательный

Имя EPG.

forged_transmits

строка

Состояние разрешения поддельных передач для связи с доменом. Этот атрибут можно использовать только для связи с доменом VMM.

Варианты:

  • "accept"
  • "reject" ← (по умолчанию)

host

псевдонимы: hostname

строка

IP-адрес или имя хоста узла ACI Multi Site Orchestrator.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения MSO_HOST.

login_domain

строка

Имя домена входа, используемое для аутентификации.

Значение по умолчанию — Local.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения MSO_LOGIN_DOMAIN.

При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаризации ansible_httpapi_login_domain.

mac_changes

строка

Состояние изменений MAC-адресов для связи с доменом. Этот атрибут можно использовать только для связи с доменом VMM.

Варианты:

  • "accept"
  • "reject" ← (по умолчанию)

micro_seg_vlan

целое число

VLAN для микросегментации. Этот атрибут можно использовать только для связи с доменом VMM.

micro_seg_vlan_type

строка

Тип VLAN для микросегментации. Этот атрибут можно использовать только для связи с доменом VMM.

Варианты:

  • "vlan"

netflow_pref

строка

Состояние предпочтения NetFlow для связи с доменом. Этот атрибут можно использовать только для связи с доменом VMM.

Варианты:

  • "enabled"
  • "disabled" ← (по умолчанию)

num_ports

целое число

Количество портов для типа привязки. Этот атрибут можно использовать только для связи с доменом VMM.

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.

port_allocation

строка

Распределение портов для типа привязки. Этот атрибут можно использовать только для связи с доменом VMM и со статическим типом привязки.

Обязателен, если binding_type=static.

Варианты:

  • "elastic"
  • "fixed"

port_encap_vlan

целое число

Тип VLAN для инкапсуляции порта. Этот атрибут можно использовать только для связи с доменом VMM.

port_encap_vlan_type

строка

Тип VLAN для инкапсуляции порта. Этот атрибут можно использовать только для связи с доменом VMM.

Варианты:

  • "vlan"

resolution_immediacy

строка

Определяет, когда политики должны быть разрешены и стать доступными.

При создании, если значение не задано, используется lazy.

Варианты:

  • "immediate"
  • "lazy"
  • "pre-provision"

schema

строка / обязательный

Имя схемы.

site

строка / обязательный

Имя сайта.

state

строка

Используйте present или absent для добавления или удаления.

Используйте query для просмотра одного или нескольких объектов.

Варианты:

  • "absent"
  • "present" ← (по умолчанию)
  • "query"

switch_type

строка

Тип коммутатора, используемый для этой связи с доменом. Этот атрибут можно использовать только для связи с доменом VMM.

switching_mode

строка

Режим коммутации, используемый для этой связи с доменом. Этот атрибут можно использовать только для связи с доменом VMM.

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

vlan_encap_mode

строка

Режим инкапсуляции 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–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_domain_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API