aci_interface_policy_port_channel – Управление политиками интерфейсов каналов портов (lacp:LagPol)
Новая в версии 2.4.
Описание
- Управление политиками интерфейсов каналов портов на фабриках Cisco ACI.
Псевдонимы: aci_intf_policy_port_channel
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| certificate_name строка | Имя сертификата X.509, прикрепленного к пользователю APIC AAA, используемому для аутентификации на основе подписи. Если был предоставлен private_key файл, значение по умолчанию устанавливается на private_key базовое имя без расширения.Если для private_key был предоставлен контент в формате PEM, значение по умолчанию устанавливается на username значение.Псевдонимы: cert_name | |
| description строка | Описание канала портов. Псевдонимы: descr | |
| fast_select логическое |
| Определяет, включён ли Fast Select для горячих резервных портов. Это формирует политику управления LACP; если задано одно значение, все другие свойства управления, оставленные неопределёнными или установленные в ложь, не будут существовать после выполнения задачи. APIC по умолчанию устанавливает yes, если значение не задано при создании. |
| graceful_convergence логическое |
| Определяет, включена ли плавная конвергенция. Это формирует политику управления LACP; если задано одно значение, все другие свойства управления, оставленные неопределёнными или установленные в ложь, не будут существовать после выполнения задачи. APIC по умолчанию устанавливает yes, если значение не задано при создании. |
| host строка / обязательно | IP-адрес или имя хоста APIC, разрешаемое управляющим хостом Ansible. Псевдонимы: имя_хоста | |
| load_defer логическое |
| Определяет, включено ли отложенное выполнение нагрузки. Это формирует политику управления LACP; если задано одно значение, все другие свойства управления, оставленные неопределёнными или установленные в ложь, не будут существовать после выполнения задачи. APIC по умолчанию устанавливает no, если значение не задано при создании. |
| max_links целое число | Максимальное количество связей. Допустимые значения находятся в диапазоне от 1 до 16. APIC по умолчанию устанавливает 16, если значение не задано при создании. | |
| min_links целое число | Минимальное количество связей. Допустимые значения находятся в диапазоне от 1 до 16. APIC по умолчанию устанавливает 1, если значение не задано при создании. | |
| mode строка |
| Режим политики интерфейса канала портов. Определяет метод LACP для формирования каналов портов. APIC по умолчанию устанавливает off, если значение не задано при создании. |
| 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. | |
| port_channel строка / обязательно | Имя канала портов. Псевдонимы: имя | |
| private_key строка / обязательно | Файл закрытого ключа в формате PEM или содержимое закрытого ключа, используемого для аутентификации на основе подписи. Это значение также влияет на значение по умолчанию certificate_name, которое используется.Этот параметр взаимоисключает password. Если также предоставлен password, он будет проигнорирован.Псевдонимы: cert_key | |
| state строка |
| Используйте present или absent для добавления или удаления.Используйте query для отображения объекта или нескольких объектов. |
| suspend_individual логическое |
| Определяет, включён ли Suspend Individual. Это формирует политику управления LACP; если задано одно значение, все другие свойства управления, оставленные неопределёнными или установленные в ложь, не будут существовать после выполнения задачи. APIC по умолчанию устанавливает yes, если значение не задано при создании. |
| symmetric_hash логическое |
| Определяет, включено ли симметричное хеширование. Это формирует политику управления LACP; если задано одно значение, все другие свойства управления, оставленные неопределёнными или установленные в ложь, не будут существовать после выполнения задачи. APIC по умолчанию устанавливает no, если значение не задано при создании. |
| timeout целое число | По умолчанию: 30 | Таймаут на уровне сокета в секундах. |
| use_proxy логическое |
| Если no, прокси не будет использоваться, даже если он определён в переменной среды на целевых хостах. |
| use_ssl логическое |
| Если no, вместо стандартного HTTPS соединения будет использовано соединение HTTP. |
| username строка | По умолчанию: "admin" | Имя пользователя для аутентификации. Псевдонимы: пользователь |
| validate_certs логическое |
| Если no, сертификаты SSL не будут проверены.Это следует устанавливать в no только при работе с сайтами, контролируемыми лично, которые используют самозаверяющие сертификаты. |
См. также
См. также
- Справочник по модели управления информацией APIC
- Дополнительная информация об внутреннем классе APIC lacp:LagPol.
- Руководство Cisco ACI
- Подробная информация о том, как управлять вашей инфраструктурой ACI с помощью Ansible.
- Разработка модулей Cisco ACI
- Подробное руководство по написанию собственных модулей Cisco ACI для участия в проекте.
Примеры
- aci_interface_policy_port_channel:
host: '{{ inventory_hostname }}'
username: '{{ username }}'
password: '{{ password }}'
port_channel: '{{ port_channel }}'
description: '{{ description }}'
min_links: '{{ min_links }}'
max_links: '{{ max_links }}'
mode: '{{ mode }}'
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие являются полями, уникальными для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| 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_interface_policy_port_channel_module.html