Spec-Zone.ru › Ansible

Модуль cisco.mso.mso_schema_template_bd — Управление доменными мостами (BD) в шаблонах схем

Примечание

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

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

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

Для использования в плейбуке укажите: cisco.mso.mso_schema_template_bd.

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

Обзор

  • Управление доменными мостами (BD) в шаблонах схем на Cisco ACI Multi-Site.

Требования

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

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

Параметры

Параметр

Комментарии

arp_flooding

boolean

Рассылка ARP

Варианты:

  • false
  • true

bd

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

строка

Имя управляемой области BD.

description

строка

Описание BD поддерживается в версиях MSO 3.3 и выше.

dhcp_policies

список / элементы=словарь

Список DHCP политик, которые следует связать с BD.

Этот параметр можно использовать только в версиях MSO 3.1.1h и выше.

dhcp_option_policy

словарь

Политика DHCP опций

name

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

Имя политики DHCP опций

version

целое число / обязательно

Версия политики DHCP опций

name

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

Имя политики DHCP релеев

version

целое число / обязательно

Версия политики DHCP релеев

dhcp_policy

словарь

Политика DHCP

dhcp_option_policy

словарь

Политика DHCP опций

name

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

Имя политики DHCP опций

version

целое число / обязательно

Версия политики DHCP опций

name

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

Имя политики DHCP релеев

version

целое число / обязательно

Версия политики DHCP релеев

display_name

строка

Имя, отображаемое на веб-интерфейсе MSO.

host

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

строка

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

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

intersite_bum_traffic

boolean

Разрешить межсайтовый трафик BUM.

Варианты:

  • false
  • true

ipv6_unknown_multicast_flooding

строка

IPv6 Unknown Multicast Flooding может быть Flood или Optimized Flooding

Варианты:

  • "flood"
  • "optimized_flooding"

layer2_stretch

boolean

Включить L2 stretch.

Варианты:

  • false
  • true ← (по умолчанию)

layer2_unknown_unicast

строка

Неизвестный одноадресная рассылка Layer2.

Варианты:

  • "flood"
  • "proxy"

layer3_multicast

boolean

Включить L3 multicast.

Варианты:

  • false
  • true

login_domain

string

Имя домена входа для аутентификации.

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

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

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

multi_destination_flooding

string

Многоадресная рассылка может быть настроена как Flood в BD, Drop или Flood в инкапсуляции.

Flood в инкапсуляции поддерживается только в версиях MSO 3.3 и выше.

Варианты:

  • "flood_in_bd"
  • "drop"
  • "encap-flood"

multicast_route_map_destination_filter

string

Имя фильтра маршрутной карты назначения.

Фильтр маршрутной карты назначения должен находиться в том же тененте, что и тенент, связанный со схемой.

Этот параметр можно использовать только в том случае, если для BD включен многоадресной обмен данными 3-го уровня.

multicast_route_map_source_filter

string

Имя фильтра маршрутной карты источника.

Фильтр маршрутной карты источника должен находиться в том же тененте, что и тенент, связанный со схемой.

Этот параметр можно использовать только в том случае, если для BD включен многоадресной обмен данными 3-го уровня.

optimize_wan_bandwidth

boolean

Оптимизировать пропускную способность WAN.

Варианты:

  • false
  • true

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.

schema

string / обязательно

Имя схемы.

state

string

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

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

Варианты:

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

subnets

список / элементы=словарь

Подсети, связанные с этим BD.

description

строка

Описание этой подсети.

no_default_gateway

boolean

Указание наличия шлюза по умолчанию для этой подсети.

Варианты:

  • false ← (по умолчанию)
  • true

primary

boolean

Признак основной подсети.

В рамках одной семьи адресов в BD может быть только одна основная подсеть.

Этот параметр доступен в версиях MSO 3.1.1h и выше.

Варианты:

  • false ← (по умолчанию)
  • true

querier

boolean

Указывает, является ли эта подсеть запроситель IGMP.

Варианты:

  • false ← (по умолчанию)
  • true

scope

строка

Область подсети.

Варианты:

  • "private" ← (по умолчанию)
  • "public"

shared

boolean

Указывает, является ли эта подсеть общей для нескольких VRF.

Варианты:

  • false ← (по умолчанию)
  • true

subnet

aliases: ip

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

Диапазон IP-адресов в CIDR-нотации.

virtual

логическое

Обрабатывать как виртуальный IP-адрес.

Выбор:

  • false ← (по умолчанию)
  • true

template

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

Имя шаблона.

Имя шаблона для операций отображается только в некоторых версиях mso.

Используйте имя шаблона вместо имени для отображения, чтобы избежать расхождений.

timeout

целое число

Таймаут уровня сокета в секундах.

Значение по умолчанию — 30 секунд.

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

unicast_routing

логическое

Одноадресная маршрутизация

Этот параметр можно использовать только в версиях MSO 3.1.1h и выше.

Выбор:

  • false
  • true

unknown_multicast_flooding

строка

Неизвестное многоадресное флудирование может быть флудированием или оптимизированным флудированием.

Выбор:

  • "flood"
  • "optimized_flooding"

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

virtual_mac_address

строка

Виртуальный MAC-адрес

vrf

словарь

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

name

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

Имя VRF для ассоциации.

schema

строка

Схема, которая определяет указанный VRF.

Если этот параметр не указан, используется текущая схема.

template

строка

Шаблон, который определяет указанный VRF.

Если этот параметр не указан, используется текущий шаблон.

Примечания

Примечание

  • Этот модуль был написан для поддержки Multi Site Orchestrator v2.1 и новее. Некоторая или вся функциональность может не работать в более ранних версиях.

Примеры

- name: Add a new BD
  cisco.mso.mso_schema_template_bd:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    bd: BD 1
    vrf:
      name: VRF1
    state: present

- name: Add a new BD from another Schema
  mso_schema_template_bd:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    bd: BD 1
    vrf:
      name: VRF1
      schema: Schema Origin
      template: Template Origin
    state: present

- name: Add bd with options available on version 3.1
  mso_schema_template_bd:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    bd: BD 1
    intersite_bum_traffic: true
    optimize_wan_bandwidth: false
    layer2_stretch: true
    layer2_unknown_unicast: flood
    layer3_multicast: false
    unknown_multicast_flooding: flood
    multi_destination_flooding: drop
    ipv6_unknown_multicast_flooding: flood
    arp_flooding: false
    virtual_mac_address: 00:00:5E:00:01:3C
    subnets:
      - subnet: 10.0.0.128/24
      - subnet: 10.0.1.254/24
        description: 1234567890
      - ip: 192.168.0.254/24
        description: "My description for a subnet"
        scope: private
        shared: false
        no_default_gateway: true
    vrf:
      name: vrf1
      schema: Test
      template: Template1
    dhcp_policy:
      name: ansible_test
      version: 1
      dhcp_option_policy:
        name: ansible_test_option
        version: 1
    state: present

- name: Add bd with options available on version 3.1.1h or greater
  mso_schema_template_bd:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    bd: BD 1
    intersite_bum_traffic: true
    optimize_wan_bandwidth: false
    layer2_stretch: true
    layer2_unknown_unicast: flood
    layer3_multicast: false
    unknown_multicast_flooding: flood
    multi_destination_flooding: drop
    ipv6_unknown_multicast_flooding: flood
    arp_flooding: false
    virtual_mac_address: 00:00:5E:00:01:3C
    unicast_routing: true
    subnets:
      - subnet: 10.0.0.128/24
        primary: true
      - subnet: 10.0.1.254/24
        description: 1234567890
        virtual: true
      - ip: 192.168.0.254/24
        description: "My description for a subnet"
        scope: private
        shared: false
        no_default_gateway: true
    vrf:
      name: vrf1
      schema: Schema1
      template: Template1
    dhcp_policies:
      - name: ansible_test
        version: 1
        dhcp_option_policy:
          name: ansible_test_option
          version: 1
      - name: ansible_test2
        version: 1
        dhcp_option_policy:
          name: ansible_test_option2
          version: 1
      - name: ansible_test3
        version: 1
        dhcp_option_policy:
          name: ansible_test_option
          version: 1
    state: present

- name: Remove a BD
  cisco.mso.mso_schema_template_bd:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    bd: BD1
    state: absent

- name: Query a specific BD
  cisco.mso.mso_schema_template_bd:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    bd: BD1
    state: query
  register: query_result

- name: Query all BDs
  cisco.mso.mso_schema_template_bd:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    state: query
  register: query_result

Авторы

  • Dag Wieers (@dagwieers)
  • Shreyas Srish (@shrsr)

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

  • Система отслеживания ошибок
  • Главная страница
  • Репозиторий (исходные коды)

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

Spec-Zone.ru

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