aci_domain – Управление профилями физических, виртуальных, коммутируемых, маршрутизируемых или FC доменов (phys:DomP, vmm:DomP, l2ext:DomP, l3ext:DomP, fc:DomP)
Новая в версии 2.5.
Описание
- Управление профилями физических, виртуальных, коммутируемых, маршрутизируемых или FC доменов на тканях Cisco ACI.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| certificate_name строка | Имя сертификата X.509, прикрепленного к пользователю APIC AAA, используемому для аутентификации на основе подписи. Если был предоставлен private_key имя файла, по умолчанию используется private_key без расширения.Если для private_key был предоставлен контент в формате PEM, по умолчанию используется значение username. псевдонимы: cert_name | |
| domain строка | Имя профиля физического, виртуального, коммутируемого, маршрутизируемого или FC домена. псевдонимы: domain_name, domain_profile, name | |
| domain_type строка |
| Тип профиля домена. fc: Профиль домена FC — это политика, относящаяся к отдельному домену управления FC.l2dom: Профиль внешнего коммутируемого домена — это политика для управления L2 коммутируемой инфраструктурой, коммутируемой за пределами ткани.l3dom: Профиль внешнего маршрутизируемого домена — это политика для управления L3 маршрутизируемой инфраструктурой за пределами ткани.phys: Профиль физического домена хранит физические ресурсы и ресурсы инкапсуляции, которые должны использоваться для EPG, связанных с этим доменом.vmm: Профиль домена VMM — это политика для группирования контроллеров VM с аналогичными требованиями к сетевой политике.псевдонимы: type |
| dscp строка |
| Целевое значение Differentiated Service (DSCP). APIC по умолчанию использует значение unspecified при отсутствии задания при создании.псевдонимы: target |
| encap_mode строка |
| Протокол инкапсуляции уровня 2, который необходимо использовать с виртуальным коммутатором. |
| host строка / обязательно | IP-адрес или имя хоста, разрешимые контрольным хостом Ansible. псевдонимы: hostname | |
| multicast_address строка | Многоадресной IP-адрес для использования с виртуальным коммутатором. | |
| 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 для отображения объекта или нескольких объектов. |
| timeout целое число | По умолчанию: 30 | Таймаут уровня сокета в секундах. |
| use_proxy булево |
| Если no, прокси не будет использоваться, даже если он определён в переменной среды на целевых хостах. |
| use_ssl булево |
| Если no, вместо стандартного HTTPS подключения будет использовано HTTP подключение. |
| username строка | По умолчанию: "admin" | Имя пользователя для аутентификации. псевдонимы: user |
| validate_certs булево |
| Если no, сертификаты SSL не будут проверены.Это следует устанавливать в no только при работе с сайтами, контролируемыми лично, использующими самозаверенные сертификаты. |
| vm_provider строка |
| Платформа VM для доменов VMM. Поддержка Kubernetes была добавлена в ACI v3.0. Поддержка CloudFoundry, OpenShift и Red Hat была добавлена в ACI v3.1. |
| vswitch строка |
| Виртуальный коммутатор для использования с доменами vmm. APIC по умолчанию использует значение default при отсутствии задания при создании. |
См. также
См. также
- aci_aep_to_domain – Привязка AEP к физическим или виртуальным доменам (infra:RsDomP)
- Официальная документация по модулю aci_aep_to_domain.
- aci_domain_to_encap_pool – Привязка домена к пулам Encap (infra:RsVlanNs)
- Официальная документация по модулю aci_domain_to_encap_pool.
- aci_domain_to_vlan_pool – Привязка домена к пулам VLAN (infra:RsVlanNs)
- Официальная документация по модулю aci_domain_to_vlan_pool.
- Справочник по модели управления информацией APIC
- Дополнительная информация о внутренних классах APIC phys:DomP, vmm:DomP, l2ext:DomP, l3ext:DomP и fc:DomP
- Руководство по Cisco ACI
- Подробная информация о том, как управлять вашей инфраструктурой ACI с помощью Ansible.
- Разработка модулей Cisco ACI
- Подробное руководство по написанию собственных модулей Cisco ACI для внесения вклада.
Примеры
- name: Add a new physical domain
aci_domain:
host: apic
username: admin
password: SomeSecretPassword
domain: phys_dom
domain_type: phys
state: present
- name: Remove a physical domain
aci_domain:
host: apic
username: admin
password: SomeSecretPassword
domain: phys_dom
domain_type: phys
state: absent
- name: Add a new VMM domain
aci_domain:
host: apic
username: admin
password: SomeSecretPassword
domain: hyperv_dom
domain_type: vmm
vm_provider: microsoft
state: present
delegate_to: localhost
- name: Remove a VMM domain
aci_domain:
host: apic
username: admin
password: SomeSecretPassword
domain: hyperv_dom
domain_type: vmm
vm_provider: microsoft
state: absent
delegate_to: localhost
- name: Query a specific physical domain
aci_domain:
host: apic
username: admin
password: SomeSecretPassword
domain: phys_dom
domain_type: phys
state: query
delegate_to: localhost
register: query_result
- name: Query all domains
aci_domain:
host: apic
username: admin
password: SomeSecretPassword
domain_type: phys
state: query
delegate_to: localhost
register: query_result
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| 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. [сертифицировано]
Авторы
- Dag Wieers (@dagwieers)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/aci_domain_module.html
