aci_bd_to_l3out – Связывание домена моста с L3 Out (fv:RsBDToOut)
Новая версия с 2.4.
Краткое описание
- Связывание домена моста с L3 Out на фэйбры Cisco ACI.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| bd строка | Имя домена моста. алиасы: bd_name, bridge_domain | |
| certificate_name строка | Имя X.509 сертификата, прикреплённого к пользователю APIC AAA, используемому для аутентификации на основе подписи. Если было предоставлено имя файла private_key, по умолчанию используется private_key без расширения.Если для private_key был предоставлен контент в формате PEM, по умолчанию используется значение username. алиасы: cert_name | |
| host строка / обязательно | IP-адрес или имя хоста APIC, разрешаемое управляющим хостом Ansible. алиасы: hostname | |
| l3out строка | Имя l3out для ассоциации с доменом моста. | |
| output_level строка |
| Влияет на вывод этого модуля ACI. normal означает стандартный вывод, включая current словарьinfo добавляет информативный вывод, включая previous, proposed и sent словариdebug добавляет отладочный вывод, включая filter_string, method, response, status и url информацию |
| password строка / обязательно | Пароль для аутентификации. Этот параметр взаимоисключает private_key. Если также предоставлено private_key, будет использоваться оно. | |
| port целое число | Номер порта для подключения REST. Значение по умолчанию зависит от параметра use_ssl. | |
| private_key строка / обязательно | Файл закрытого ключа в формате PEM или содержание закрытого ключа, используемого для аутентификации на основе подписи. Это значение также влияет на значение по умолчанию certificate_name, которое используется.Этот параметр взаимоисключает password. Если также предоставлено password, оно будет проигнорировано.алиасы: cert_key | |
| state строка |
| Используйте present или absent для добавления или удаления.Используйте query для отображения объекта или нескольких объектов. |
| tenant строка | Имя арендатора. алиасы: tenant_name | |
| timeout целое число | Значение по умолчанию: 30 | Таймаут сокета в секундах. |
| use_proxy булево |
| Если no, прокси не будет использоваться, даже если он определён в переменной среды на целевых хостах. |
| use_ssl булево |
| Если no, вместо стандартного HTTPS подключения будет использоваться HTTP подключение. |
| username строка | Значение по умолчанию: "admin" | Имя пользователя для аутентификации. алиасы: user |
| validate_certs булево |
| Если no, сертификаты SSL не будут проверены.Это значение должно быть no только при работе с сайтами, контролируемыми лично, использующими самоподписанные сертификаты. |
Примечания
Примечание
- Параметры
bdиl3outдолжны существовать перед использованием этого модуля. Для этого можно использовать модули aci_bd иaci_l3out.
См. также
См. также
- aci_bd – Управление объектами доменов моста (BD) (fv:BD)
- Официальная документация по модулю aci_bd.
- aci_l3out – Управление объектами внешних L3 (L3Out) (l3ext:Out)
- Официальная документация по модулю aci_l3out.
- Справочник по модели управления информацией APIC
- Дополнительная информация о внутренней класс APIC fv:RsBDToOut.
- Руководство Cisco ACI
- Подробная информация о том, как управлять инфраструктурой ACI с помощью Ansible.
- Разработка модулей Cisco ACI
- Подробное руководство по написанию собственных модулей Cisco ACI для внесения вклада.
Примеры
#
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращено | Описание |
|---|---|---|
| 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 строка | ошибка парсинга | Необработанный результат, возвращенный APIC REST API (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 |
Статус
- Данный модуль не гарантирует обратной совместимости. [preview]
- Этот модуль поддерживается партнером Ansible. [certified]
Авторы
- 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_to_l3out_module.html