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