aci_vrf - Управление контекстами или VRF (fv:Ctx)
Новое в версии 2.4.
Обзор
- Управление контекстами или VRF на Cisco ACI сетях.
- Каждый контекст — это частная сеть, связанная с арендатором, т.е. VRF.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| certificate_name | По умолчанию: C(private_key) basename | Имя сертификата X.509, прикрепленного к пользователю APIC AAA, используемому для аутентификации на основе подписи. По умолчанию это private_key basename без расширения.Псевдонимы: cert_name |
| description | Описание VRF. Псевдонимы: descr | |
| host обязательно | IP-адрес или имя хоста APIC, разрешимые управляющим хостом Ansible. Псевдонимы: hostname | |
| output_level |
| Влияет на вывод этого модуля ACI. normal означает стандартный вывод, включая current словарь.info означает информационный вывод, включая previous, proposed и sent словари.debug означает отладочный вывод, включая filter_string, method, response, status и url информацию. |
| password обязательно | Пароль для аутентификации. | |
| policy_control_direction |
| Определяет, должна ли политика применяться в сети при поступлении или выходе данных. |
| policy_control_preference |
| Определяет, должна ли материнская плата принудительно применять политики контракта. |
| port | По умолчанию: 443 (для https) и 80 (для http) | Номер порта для подключения REST. |
| private_key | Файл в формате PEM, содержащий ваш закрытый ключ, используемый для аутентификации на основе подписи. Имя ключа (без расширения) используется в ACI как имя сертификата, если не указано certificate_name. Псевдонимы: cert_key | |
| state |
| Используйте present или absent для добавления или удаления.Используйте query для получения списка объекта или нескольких объектов. |
| tenant | Имя арендатора, к которому должен принадлежать VRF. Псевдонимы: tenant_name | |
| timeout | По умолчанию: 30 | Таймаут уровня сокета в секундах. |
| use_proxy |
| Если no, прокси не будет использоваться, даже если он определён в переменной среды на целевых хостах. |
| use_ssl |
| Если no, будет использоваться HTTP-соединение вместо стандартного HTTPS-соединения. |
| username обязательно | По умолчанию: admin | Имя пользователя для аутентификации. Псевдонимы: user |
| validate_certs |
| Если no, сертификаты SSL не будут проверены.Это следует установить только на no сайтах с самозаверенными сертификатами. |
| vrf | Имя VRF. Псевдонимы: context, name, vrf_name |
Примечания
Примечание
- Перед использованием этого модуля в вашей книге задач должен существовать
tenant. Для этого можно использовать модуль aci_tenant. - Дополнительную информацию о внутреннем классе APIC fv:Ctx см. в справке по модели управления информацией APIC.
- По умолчанию, если на целевом хосте установлена переменная среды
<protocol>_proxy, запросы будут отправляться через этот прокси. Это поведение можно переопределить, задав переменную для этой задачи (см. настройка среды), или используя параметрuse_proxy. - HTTP-редиректы могут перенаправлять с HTTP на HTTPS, поэтому убедитесь, что ваша среда прокси для обоих протоколов правильная.
Примеры
- name: Add a new VRF to a tenant
aci_vrf:
host: apic
username: admin
password: SomeSecretPassword
vrf: vrf_lab
tenant: lab_tenant
descr: Lab VRF
policy_control_preference: enforced
policy_control_direction: ingress
state: present
- name: Remove a VRF for a tenant
aci_vrf:
host: apic
username: admin
password: SomeSecretPassword
vrf: vrf_lab
tenant: lab_tenant
state: absent
- name: Query a VRF of a tenant
aci_vrf:
host: apic
username: admin
password: SomeSecretPassword
vrf: vrf_lab
tenant: lab_tenant
state: query
- name: Query all VRFs
aci_vrf:
host: apic
username: admin
password: SomeSecretPassword
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 строка | ошибка разбора | Необработанный вывод, возвращенный 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-адрес, используемый для запроса к APIC Пример: https://10.11.12.13/api/mo/uni/tn-production.json |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость.
Автор
- 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.5/modules/aci_vrf_module.html
