aci_static_binding_to_epg - Связывание статических путей с EPG (fv:RsPathAtt)
Новая в версии 2.5.
Краткое описание
- Связывание статических путей с EPG на фэбриках Cisco ACI.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| ap | Имя существующего профиля сети приложения, который будет содержать EPG. Псевдонимы: app_profile, app_profile_name | |
| certificate_name | По умолчанию: C(private_key) basename | Имя сертификата X.509, прикрепленного к пользователю APIC AAA, используемому для аутентификации на основе подписи. По умолчанию равно private_key basename без расширения.Псевдонимы: cert_name |
| deploy_immediacy |
| Немедленное развертывание статического EPG на PC, VPC или интерфейсе. APIC по умолчанию устанавливает немедленное развертывание на lazy. |
| encap_id |
| Идентификатор инкапсуляции, связывающий epg с путем интерфейса.Действует как вторичный encap_id при использовании микросегментации.Псевдонимы: vlan, vlan_id |
| epg | Имя группы конечных точек. Псевдонимы: epg_name | |
| extpaths | Часть целого значения extpaths в tDn.extpaths используется только если interface_type равно fex.Обычно что-то вроде '1011'. | |
| host обязательно | IP-адрес или имя хоста APIC, разрешаемый хостом управления Ansible. Псевдонимы: hostname | |
| interface | Часть строкового значения interface в tDn.Обычно группа политик, например, "test-IntPolGrp", или интерфейс следующего формата "1/7", в зависимости от interface_type. | |
| interface_mode |
| Определяет, как теги уровня 2 будут считываться и добавляться к кадрам. Значения 802.1p и native идентичны.Значения access и untagged идентичны.Значения regular, tagged и trunk идентичны.APIC по умолчанию устанавливает режим на trunk.Псевдонимы: interface_mode_name, mode |
| interface_type |
| Тип интерфейса для развертывания статического EPG. APIC по умолчанию устанавливает interface_type на switch_port. |
| leafs | Идентификатор(ы) коммутатора, к которому принадлежит interface.Когда interface_type равно switch_port, port_channel, или fex, тогда leafs является строкой идентификатора листа.Когда interface_type равно vpc, тогда leafs — список с обоими идентификаторами листов.Значение leafs обычно равно '101' или '101-102' в зависимости от connection_type.Псевдонимы: leaves, nodes, paths, switches | |
| output_level |
| Влияет на вывод этого модуля ACI. normal означает стандартный вывод, включая current dictinfo означает информативный вывод, включая previous, proposed и sent dictsdebug означает отладочный вывод, включая filter_string, method, response, status и url информацию |
| password обязательно | Пароль для аутентификации. | |
| pod_id | Номер подсети в tDn. pod_id обычно целое число меньше 10.Псевдонимы: pod, pod_number | |
| port | По умолчанию: 443 (для https) и 80 (для http) | Номер порта для подключения REST. |
| primary_encap_id |
| Определяет первичный идентификатор инкапсуляции, связывающий epg с путем интерфейса при использовании микросегментации.Псевдонимы: primary_vlan, primary_vlan_id |
| private_key | Файл в формате PEM, содержащий ваш закрытый ключ для аутентификации на основе подписи. Имя ключа (без расширения) используется в ACI в качестве имени сертификата, если не указано certificate_name.Псевдонимы: 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 контролируемых сайтах с самоподписанными сертификатами. |
Примечания
Примечание
tenant,ap,epgдолжны существовать до использования этого модуля в вашем плейбуке. Для этого можно использовать модули aci_tenant, aci_ap, aci_epg.- Дополнительную информацию о внутренних классах APIC fv:RsPathAtt см. в справочнике по модели управления информацией APIC здесь.
- По умолчанию, если на целевом узле установлена переменная среды
<protocol>_proxy, запросы будут отправлены через этот прокси. Это поведение можно переопределить, установив переменную для этой задачи (см. настройка среды) или с помощью параметраuse_proxy. - HTTP-перенаправления могут перенаправлять с HTTP на HTTPS, поэтому убедитесь, что ваша среда прокси для обоих протоколов правильная.
Примеры
- name: Deploy Static Path binding for given EPG
aci_static_binding_to_epg:
host: apic
username: admin
password: SomeSecretPassword
tenant: accessport-code-cert
ap: accessport_code_app
epg: accessport_epg1
encap_id: 222
deploy_immediacy: lazy
interface_mode: untagged
interface_type: switch_port
pod_id: 1
leafs: 101
interface: '1/7'
state: present
- name: Remove Static Path binding for given EPG
aci_static_binding_to_epg:
host: apic
username: admin
password: SomeSecretPassword
tenant: accessport-code-cert
ap: accessport_code_app
epg: accessport_epg1
interface_type: switch_port
pod: 1
leafs: 101
interface: '1/7'
state: absent
- name: Get specific Static Path binding for given EPG
aci_static_binding_to_epg:
host: apic
username: admin
password: SomeSecretPassword
tenant: accessport-code-cert
ap: accessport_code_app
epg: accessport_epg1
interface_type: switch_port
pod: 1
leafs: 101
interface: '1/7'
state: query
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| current список | успех | Текущая конфигурация из APIC после завершения модуля Пример: [{'fvTenant': {'attributes': {'dn': 'uni/tn-production', 'ownerKey': '', 'name': 'production', 'descr': 'Производственная среда', 'nameAlias': '', 'ownerTag': ''}}}] |
| error словарь | ошибка | Информация об ошибке, возвращённая APIC Пример: {'text': 'неизвестный класс управляемого объекта foo', 'code': '122'} |
| filter_string строка | ошибка или отладка | Строка фильтра, используемая для запроса Пример: ?rsp-prop-include=config-only |
| method строка | ошибка или отладка | HTTP-метод, используемый для запроса к APIC Пример: POST |
| previous список | информация | Исходная конфигурация из APIC до запуска модуля Пример: [{'fvTenant': {'attributes': {'dn': 'uni/tn-production', 'ownerKey': '', 'name': 'production', 'descr': 'Производство', 'nameAlias': '', 'ownerTag': ''}}}] |
| proposed словарь | информация | Сборка конфигурации из предоставленных пользователем параметров Пример: {'fvTenant': {'attributes': {'name': 'production', 'descr': 'Производственная среда'}}} |
| 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 |
Статус
Этот модуль помечен как предварительный, что означает, что он не гарантирует обратную совместимость.
Автор
- Bruno Calogero (@brunocalogero)
Подсказка
Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/aci_static_binding_to_epg_module.html
