aci_bd – Управление объектами доменных мостов (BD) (fv:BD)

Новая версия 2.4.

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

Обзор

Управление доменными мостами (BD) на тканях Cisco ACI.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
arp_flooding boolean	Варианты: no yes	Определяет, будет ли домен моста пересылать трафик ARP. APIC по умолчанию использует `no` при отсутствии задания при создании.
bd string		Имя домена моста. псевдонимы: bd_name, name
bd_type string	Варианты: ethernet fc	Тип трафика в домене моста. APIC по умолчанию использует `ethernet` при отсутствии задания при создании.
certificate_name string		Имя сертификата X.509, прикреплённого к пользователю APIC AAA, используемому для аутентификации на основе подписи. Если был предоставлен файл с именем `private_key`, по умолчанию используется имя файла `private_key`, без расширения. Если для `private_key` был предоставлен контент в формате PEM, по умолчанию используется значение `username`. псевдонимы: cert_name
description string		Описание домена моста.
enable_multicast boolean	Варианты: no yes	Определяет, включен ли PIM. APIC по умолчанию использует `no` при отсутствии задания при создании.
enable_routing boolean	Варианты: no yes	Определяет, разрешено ли перенаправление IP. APIC по умолчанию использует `yes` при отсутствии задания при создании.
endpoint_clear boolean	Варианты: no yes	Очищает все конечные точки на всех листьях при `yes`. Значение не сбрасывается до отключенного после очистки конечных точек; для этого требуется вторая задача. APIC по умолчанию использует `no` при отсутствии задания при создании.
endpoint_move_detect string	Варианты: default garp	Определяет, будет ли включен GARP для обнаружения перемещения конечных точек. APIC по умолчанию использует `garp` при отсутствии задания при создании.
endpoint_retention_action string	Варианты: inherit resolve	Определяет, должен ли домен моста наследовать или разрешать политику сохранения конечных точек. APIC по умолчанию использует `resolve` при отсутствии задания при создании.
endpoint_retention_policy string		Имя политики сохранения конечных точек, которую должен использовать домен моста при переопределении политики сохранения конечных точек по умолчанию.
host string / обязательно		IP-адрес или имя хоста APIC, разрешимые для управляющего хоста Ansible. псевдонимы: hostname
igmp_snoop_policy string		Имя политики IGMP Snooping, которую должен использовать домен моста при переопределении политики IGMP Snooping по умолчанию.
ip_learning boolean	Варианты: no yes	Определяет, должен ли домен моста изучать IP-адреса конечных точек. APIC по умолчанию использует `yes` при отсутствии задания при создании.
ipv6_nd_policy string		Имя политики IPv6 Neighbor Discovery, которую должен использовать домен моста при переопределении политики IPV6 ND по умолчанию.
l2_unknown_unicast string	Варианты: proxy flood	Определяет метод переадресации для неизвестных L2-назначений. APIC по умолчанию использует `proxy` при отсутствии задания при создании.
l3_unknown_multicast string	Варианты: flood opt-flood	Определяет метод переадресации для неизвестных мультимедиа-назначений. APIC по умолчанию использует `flood` при отсутствии задания при создании.
limit_ip_learn boolean	Варианты: no yes	Определяет, должен ли BD ограничивать обучение IP только для подсетей, принадлежащих домену моста. APIC по умолчанию использует `yes` при отсутствии задания при создании.
mac_address string добавлено в 2.5		MAC-адрес, который нужно назначить `bd`, вместо использования значения по умолчанию. APIC по умолчанию использует `00:22:BD:F8:19:FF` при отсутствии задания при создании. псевдонимы: mac
multi_dest string	Варианты: bd-flood drop encap-flood	Определяет метод переадресации для L2 мультимедиа, широковещательного и трафика на уровне канала связи. APIC по умолчанию использует `bd-flood` при отсутствии задания при создании.
output_level string	Варианты: debug info normal ←	Влияет на вывод этого модуля ACI. `normal` означает стандартный вывод, включая `current` dict `info` добавляет информативный вывод, включая `previous`, `proposed` и `sent` dicts `debug` добавляет отладочный вывод, включая `filter_string`, `method`, `response`, `status` и `url` информацию
password string / обязательно		Пароль для аутентификации. Этот параметр исключает `private_key`. Если также указано `private_key`, будет использовано это значение.
port integer		Номер порта для подключения REST. Значение по умолчанию зависит от параметра `use_ssl`.
private_key string / обязательно		Файл с закрытым ключом в формате PEM или содержимое закрытого ключа, используемого для аутентификации на основе подписи. Это значение также влияет на значение `certificate_name` по умолчанию. Этот параметр исключает `password`. Если также указано `password`, это значение будет проигнорировано. псевдонимы: cert_key
state string	Варианты: absent present ← query	Используйте `present` или `absent` для добавления или удаления. Используйте `query` для отображения объекта или нескольких объектов.
tenant string		Имя клиента. псевдонимы: tenant_name
timeout integer	По умолчанию: 30	Таймаут уровня сокета в секундах.
use_proxy boolean	Варианты: no yes ←	Если `no`, прокси не будет использоваться, даже если он определен в переменной окружения на целевых хостах.
use_ssl boolean	Варианты: no yes ←	Если `no`, будет использовано HTTP-соединение вместо стандартного HTTPS-соединения.

Имя пользователя строка	По умолчанию: "admin"	Имя пользователя для аутентификации. псевдонимы: пользователь
validate_certs булево	Варианты: нет да ←	Если `no`, сертификаты SSL не будут проверены. Это следует устанавливать в `no` только при работе с сайтами под собственным контролем, использующими самозаверяющие сертификаты.
vrf строка		Имя VRF. псевдонимы: vrf_name

Примечания

Примечание

Перед использованием этого модуля в вашей книге задач должен существовать tenant. Для этого можно использовать модуль aci_tenant.

См. также

aci_tenant – Управление клиентами (fv:Tenant): Официальная документация по модулю aci_tenant.
Справочник по модели управления информацией APIC: Дополнительная информация об внутренней службе APIC fv:BD.
Руководство по Cisco ACI: Подробная информация о том, как управлять вашей инфраструктурой ACI с помощью Ansible.
Разработка модулей Cisco ACI: Подробное руководство по написанию собственных модулей Cisco ACI для участия.

Примеры

- name: Add Bridge Domain
  aci_bd:
    host: "{{ inventory_hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: no
    tenant: prod
    bd: web_servers
    mac_address: 00:22:BD:F8:19:FE
    vrf: prod_vrf
    state: present
  delegate_to: localhost

- name: Add an FC Bridge Domain
  aci_bd:
    host: "{{ inventory_hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: no
    tenant: prod
    bd: storage
    bd_type: fc
    vrf: fc_vrf
    enable_routing: no
    state: present
  delegate_to: localhost

- name: Modify a Bridge Domain
  aci_bd:
    host: "{{ inventory_hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: yes
    tenant: prod
    bd: web_servers
    arp_flooding: yes
    l2_unknown_unicast: flood
    state: present
  delegate_to: localhost

- name: Query All Bridge Domains
  aci_bd:
    host: "{{ inventory_hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: yes
    state: query
  delegate_to: localhost
  register: query_result

- name: Query a Bridge Domain
  aci_bd:
    host: "{{ inventory_hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: yes
    tenant: prod
    bd: web_servers
    state: query
  delegate_to: localhost
  register: query_result

- name: Delete a Bridge Domain
  aci_bd:
    host: "{{ inventory_hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: yes
    tenant: prod
    bd: web_servers
    state: absent
  delegate_to: localhost

Значения возврата

Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
current список	успех	Существующая конфигурация из APIC после завершения модуля Пример: [{'fvTenant': {'attributes': {'descr': 'Производственная среда', 'dn': 'uni/tn-production', 'name': 'production', 'nameAlias': '', 'ownerKey': '', 'ownerTag': ''}}}]
error словарь	ошибка	Информация об ошибке, возвращенная APIC Пример: {'code': '122', 'text': 'неизвестный класс управляемого объекта foo'}
filter_string строка	ошибка или отладка	Строка фильтра, используемая для запроса Пример: ?rsp-prop-include=config-only
method строка	ошибка или отладка	HTTP-метод, используемый для запроса к APIC Пример: POST
previous список	информация	Исходная конфигурация из APIC до начала работы модуля Пример: [{'fvTenant': {'attributes': {'descr': 'Производство', 'dn': 'uni/tn-production', 'name': 'production', 'nameAlias': '', 'ownerKey': '', 'ownerTag': ''}}}]
proposed словарь	информация	Собранная конфигурация из параметров, предоставленных пользователем Пример: {'fvTenant': {'attributes': {'descr': 'Производственная среда', 'name': 'production'}}}
raw строка	ошибка разбора	Необработанный вывод, возвращенный API REST APIC (xml или json) Пример: <?xml version="1.0" encoding="UTF-8"?><imdata totalCount="1"><error code="122" text="неизвестный класс управляемого объекта foo"/></imdata>
response строка	ошибка или отладка	HTTP-ответ от APIC Пример: OK (30 байт)
sent список	информация	Фактическая/минимальная конфигурация, отправленная в APIC Пример: {'fvTenant': {'attributes': {'descr': 'Производственная среда'}}}
status целое число	ошибка или отладка	HTTP-статус от APIC Пример: 200
url строка	ошибка или отладка	HTTP-URL, используемый для запроса к APIC Пример: https://10.11.12.13/api/mo/uni/tn-production.json

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается партнером Ansible. [сертифицировано]

Авторы

Jacob McGill (@jmcgill298)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете редактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/aci_bd_module.html