aci_interface_policy_port_channel - Управление политиками интерфейсов каналов портов (lacp:LagPol)
Новая версия 2.4.
Обзор
- Управление политиками интерфейсов каналов портов на тканях Cisco ACI.
Псевдонимы: aci_intf_policy_port_channel
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| certificate_name | По умолчанию: C(private_key) basename | Имя сертификата X.509, прикрепленного к пользователю APIC AAA, используемому для аутентификации на основе подписи. По умолчанию, private_key basename без расширения.Псевдонимы: cert_name |
| description | Описание канала порта. Псевдонимы: descr | |
| fast_select |
| Определяет, включен ли быстрый выбор для портов активного резервирования. Это формирует политику управления LACP; если одно значение определено, все другие свойства управления, оставленные неопределенными или установленные в ложь, будут удалены после выполнения задачи. APIC по умолчанию устанавливает новые политики LACP в yes. |
| graceful_convergence |
| Определяет, включена ли плавная сходимость. Это формирует политику управления LACP; если одно значение определено, все другие свойства управления, оставленные неопределенными или установленные в ложь, будут удалены после выполнения задачи. APIC по умолчанию устанавливает новые политики LACP в yes. |
| host обязательно | IP-адрес или имя хоста APIC, разрешимое управляющим хостом Ansible. Псевдонимы: имя_хоста | |
| load_defer |
| Определяет, включено ли отложенное выполнение задачи (Load Defer). Это формирует политику управления LACP; если одно значение определено, все другие свойства управления, оставленные неопределенными или установленные в ложь, будут удалены после выполнения задачи. APIC по умолчанию устанавливает новые политики LACP в no. |
| max_links |
16 | Максимальное количество каналов (диапазон 1-16). APIC по умолчанию устанавливает новые политики каналов портов в 16. |
| min_links |
1 | Минимальное количество каналов (диапазон 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 обязательно | Пароль для аутентификации. | |
| port | По умолчанию: 443 (для https) и 80 (для http) | Номер порта, используемый для подключения REST. |
| port_channel обязательно | Имя канала порта. Псевдонимы: имя | |
| private_key | Файл в формате PEM, содержащий ваш закрытый ключ, используемый для аутентификации на основе подписи. Имя ключа (без расширения) используется как имя сертификата в ACI, если не указано certificate_name.Псевдонимы: cert_key | |
| state |
| Используйте present или absent для добавления или удаления.Используйте query для вывода объекта или нескольких объектов. |
| suspend_individual |
| Определяет, включена ли функция приостановки отдельных объектов. Это формирует политику управления LACP; если одно значение определено, все другие свойства управления, оставленные неопределенными или установленные в ложь, будут удалены после выполнения задачи. APIC по умолчанию устанавливает новые политики LACP в yes. |
| symmetric_hash |
| Определяет, включено ли симметричное хэширование. Это формирует политику управления LACP; если одно значение определено, все другие свойства управления, оставленные неопределенными или установленные в ложь, будут удалены после выполнения задачи. APIC по умолчанию устанавливает новые политики LACP в no. |
| timeout | По умолчанию: 30 | Таймаут на уровне сокета в секундах. |
| use_proxy |
| Если no, прокси не будет использоваться, даже если он определен в переменной среды на целевых хостах. |
| use_ssl |
| Если no, будет использоваться HTTP-соединение вместо стандартного HTTPS-соединения. |
| username обязательно | По умолчанию: admin | Имя пользователя для аутентификации. Псевдонимы: пользователь |
| validate_certs |
| Если no, сертификаты SSL не будут проверены.Это следует устанавливать только в no на сайтах под собственным контролем, использующих самозаверенные сертификаты. |
Примечания
Примечание
- Дополнительную информацию об внутреннем классе APIC lacp:LagPol см. в справочнике по модели управления информацией APIC.
- По умолчанию, если на целевом хосте установлена переменная среды
<protocol>_proxy, запросы будут отправляться через этот прокси. Это поведение можно переопределить, установив переменную для этой задачи (см. установку окружения) или используя параметрuse_proxy. - Перенаправления HTTP могут перенаправлять с HTTP на HTTPS, поэтому убедитесь, что ваша среда прокси для обоих протоколов корректна.
Примеры
- 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 }}'
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| 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 URL, используемый для запроса к APIC. Пример: https://10.11.12.13/api/mo/uni/tn-production.json |
Состояние
Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратную совместимость.
Автор
- 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.5/modules/aci_interface_policy_port_channel_module.html
