Spec-Zone.ru › Ansible

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

Примечание

Этот модуль входит в состав коллекции cisco.mso (версия 2.13.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

string

Имя BD, которой нужно управлять.

description

string

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

dhcp_policies

list / элементы=dictionary

Список политик DHCP, связываемых с BD

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

dhcp_option_policy

dictionary

Политика параметров DHCP

name

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

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

version

integer / обязательный

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

name

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

Имя политики ретрансляции DHCP

version

integer / обязательный

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

dhcp_policy

dictionary

Политика DHCP

dhcp_option_policy

dictionary

Политика параметров DHCP

name

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

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

version

integer / обязательный

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

name

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

Имя политики ретрансляции DHCP

version

integer / обязательный

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

display_name

string

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

ep_move_detection_mode

boolean

Включает обнаружение перемещений конечных точек с помощью пакетов Gratuitous ARP (GARP).

Варианты:

  • false
  • true

host

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

string

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

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

intersite_bum_traffic

boolean

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

Варианты:

  • false
  • true

ipv6_unknown_multicast_flooding

string

Для неизвестного многоадресного трафика IPv6 можно выбрать затопление или оптимизированное затопление.

Варианты:

  • "flood"
  • "optimized_flooding"

layer2_stretch

boolean

Включить ли растяжение L2.

Варианты:

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

layer2_unknown_unicast

string

Неизвестный одноадресный трафик уровня 2.

Варианты:

  • "flood"
  • "proxy"

layer3_multicast

boolean

Включить ли многоадресную рассылку L3.

Варианты:

  • false
  • true

login_domain

string

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

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

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

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

multi_destination_flooding

string

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

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

Варианты:

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

multicast_route_map_destination_filter

string

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

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

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

Если указать пустую строку multicast_route_map_destination_filter="", фильтр назначения карты маршрутизации будет удален из BD.

multicast_route_map_source_filter

string

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

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

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

Если указать пустую строку multicast_route_map_source_filter="", фильтр источника карты маршрутизации будет удален из BD.

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

list / элементы=dictionary

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

description

string

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

no_default_gateway

boolean

Есть ли у этой подсети шлюз по умолчанию.

Варианты:

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

primary

boolean

Назначить первичной подсетью.

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

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

Варианты:

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

querier

boolean

Является ли эта подсеть IGMP-запрашивающим устройством.

Варианты:

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

scope

string

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

Варианты:

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

shared

boolean

Используется ли эта подсеть совместно между VRF.

Варианты:

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

subnet

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

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

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

virtual

boolean

Назначить виртуальным IP-адресом.

Варианты:

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

template

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

Имя шаблона.

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

Во избежание несоответствий используйте имя шаблона вместо отображаемого имени.

timeout

integer

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

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

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

unicast_routing

boolean

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

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

Варианты:

  • false
  • true

unknown_multicast_flooding

string

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

Варианты:

  • "flood"
  • "optimized_flooding"

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

virtual_mac_address

string

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

vrf

dictionary

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

name

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

Имя VRF, с которым нужно связать.

schema

string

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

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

template

string

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

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

Примечания

Примечание

  • Этот модуль разработан для поддержки Multi Site Orchestrator версии 2.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–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_template_bd_module.html

Spec-Zone.ru

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