Spec-Zone.ru › Ansible 2.8

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
строка
    Варианты:
  • debug
  • info
  • normal ←
Влияет на вывод этого модуля 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
строка
    Варианты:
  • absent
  • present ←
  • query
Используйте present или absent для добавления или удаления.
Используйте query для отображения объекта или нескольких объектов.
tenant
строка
Имя арендатора.

алиасы: tenant_name
timeout
целое число
Значение по умолчанию:
30
Таймаут сокета в секундах.
use_proxy
булево
    Варианты:
  • no
  • yes ←
Если no, прокси не будет использоваться, даже если он определён в переменной среды на целевых хостах.
use_ssl
булево
    Варианты:
  • no
  • yes ←
Если no, вместо стандартного HTTPS подключения будет использоваться HTTP подключение.
username
строка
Значение по умолчанию:
"admin"
Имя пользователя для аутентификации.

алиасы: user
validate_certs
булево
    Варианты:
  • no
  • yes ←
Если 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

Spec-Zone.ru

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