Spec-Zone.ru › Ansible 2.11

cisco.aci.aci_interface_policy_port_channel – Управление политиками интерфейсов каналов связи (lacp:LagPol)

Примечание

Этот плагин входит в коллекцию cisco.aci (версия 2.0.0).

Для его установки используйте: ansible-galaxy collection install cisco.aci.

Для использования в книге задач укажите: cisco.aci.aci_interface_policy_port_channel.

  • Обзор
  • Параметры
  • См. также
  • Примеры
  • Возвращаемые значения

Обзор

  • Управление политиками интерфейсов каналов связи на Cisco ACI фабриках.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
annotation
строка
Определённая пользователем строка для аннотации объекта.
Если значение не указано в задаче, будет использовано значение переменной окружения ACI_ANNOTATION.
certificate_name
строка
Имя сертификата X.509, прикреплённого к пользователю APIC AAA, используемому для аутентификации на основе подписи.
Если был предоставлён файл с именем private_key, по умолчанию используется имя файла private_key без расширения.
Если для private_key был предоставлен контент в формате PEM, по умолчанию используется значение username.
Если значение не указано в задаче, будет использовано значение переменной окружения ACI_CERTIFICATE_NAME.

псевдонимы: cert_name
description
строка
Описание канала порта.

псевдонимы: descr
fast_select
булево
    Варианты:
  • no
  • yes
Определяет, включена ли функция Быстрый выбор для портов резервного копирования.
Это формирует политику управления LACP; если одно из значений задано, все другие свойства управления, оставленные неопределёнными или установленные в false, не будут существовать после выполнения задачи.
APIC по умолчанию использует значение yes при отсутствии настройки во время создания.
graceful_convergence
булево
    Варианты:
  • no
  • yes
Определяет, включена ли функция Плавная конвергенция.
Это формирует политику управления LACP; если одно из значений задано, все другие свойства управления, оставленные неопределёнными или установленные в false, не будут существовать после выполнения задачи.
APIC по умолчанию использует значение yes при отсутствии настройки во время создания.
host
строка / обязательно
IP-адрес или имя хоста APIC, разрешаемое управляющим хостом Ansible.
Если значение не указано в задаче, будет использовано значение переменной окружения ACI_HOST.

псевдонимы: hostname
load_defer
булево
    Варианты:
  • no
  • yes
Определяет, включена ли отсрочка загрузки.
Это формирует политику управления LACP; если одно из значений задано, все другие свойства управления, оставленные неопределёнными или установленные в false, не будут существовать после выполнения задачи.
APIC по умолчанию использует значение no при отсутствии настройки во время создания.
max_links
целое число
Максимальное количество связей.
Допустимые значения находятся в диапазоне от 1 до 16.
APIC по умолчанию использует значение 16 при отсутствии настройки во время создания.
min_links
целое число
Минимальное количество связей.
Допустимые значения находятся в диапазоне от 1 до 16.
APIC по умолчанию использует значение 1 при отсутствии настройки во время создания.
mode
строка
    Варианты:
  • active
  • mac-pin
  • mac-pin-nicload
  • off
  • passive
Режим политики интерфейса канала порта.
Определяет метод LACP, используемый для формирования каналов портов.
APIC по умолчанию использует значение off при отсутствии настройки во время создания.
name_alias
строка
Псевдоним текущего объекта. Связан с полем nameAlias в ACI.
output_level
строка
    Варианты:
  • debug
  • info
  • normal ←
Влияет на вывод этого модуля ACI.
normal означает стандартный вывод, включая current словарь
info добавляет информационный вывод, включая previous, proposed и sent словари
debug добавляет отладочный вывод, включая filter_string, method, response, status и url информацию
Если значение не указано в задаче, будет использовано значение переменной окружения ACI_OUTPUT_LEVEL.
output_path
строка
Путь к файлу, который будет использован для вывода объектов конфигурации ACI в формате JSON, сгенерированных модулем.
Если значение не указано в задаче, будет использовано значение переменной окружения ACI_OUTPUT_PATH.
owner_key
строка
Определённая пользователем строка для атрибута ownerKey объекта ACI.
Этот атрибут представляет ключ для предоставления клиентам права собственности на их данные для корреляции сущностей.
Если значение не указано в задаче, будет использовано значение переменной окружения ACI_OWNER_KEY.
owner_tag
строка
Определённая пользователем строка для атрибута ownerTag объекта ACI.
Этот атрибут представляет метку для предоставления клиентам возможности добавлять свои собственные данные.
Например, для указания того, кто создал этот объект.
Если значение не указано в задаче, будет использовано значение переменной окружения ACI_OWNER_TAG.
password
строка
Пароль для аутентификации.
Этот параметр взаимоисключает private_key. Если private_key также предоставлен, он будет использован вместо него.
Если значение не указано в задаче, будет использовано значение переменных окружения ACI_PASSWORD или ANSIBLE_NET_PASSWORD.
port
целое число
Номер порта, используемый для подключения REST.
Значение по умолчанию зависит от параметра use_ssl.
Если значение не указано в задаче, будет использовано значение переменной окружения ACI_PORT.
port_channel
строка
Имя канала порта.

псевдонимы: name
private_key
строка
Файл приватного ключа в формате PEM или содержимое приватного ключа, используемое для аутентификации на основе подписи.
Это значение также влияет на значение по умолчанию certificate_name, которое используется.
Этот параметр взаимоисключает password. Если password также предоставлен, он будет проигнорирован.
Если значение не указано в задаче, будет использовано значение переменной окружения ACI_PRIVATE_KEY.

псевдонимы: cert_key
state
строка
    Варианты:
  • absent
  • present ←
  • query
Используйте present или absent для добавления или удаления.
Используйте query для отображения объекта или нескольких объектов.
suspend_individual
булево
    Варианты:
  • no
  • yes
Определяет, включена ли функция Подвесить индивидуально.
Это формирует политику управления LACP; если одно из значений задано, все другие свойства управления, оставленные неопределёнными или установленные в false, не будут существовать после выполнения задачи.
APIC по умолчанию использует значение yes при отсутствии настройки во время создания.
symmetric_hash
булево
    Варианты:
  • no
  • yes
Определяет, включено ли симметричное хеширование.
Это формирует политику управления LACP; если одно из значений задано, все другие свойства управления, оставленные неопределёнными или установленные в false, не будут существовать после выполнения задачи.
APIC по умолчанию использует значение no при отсутствии настройки во время создания.
timeout
целое число
Значение по умолчанию:
30
Таймаут уровня сокета в секундах.
Если значение не указано в задаче, будет использовано значение переменной окружения ACI_TIMEOUT.
use_proxy
булево
    Варианты:
  • no
  • yes ←
Если no, прокси не будет использоваться, даже если он определён в переменной окружения на целевых хостах.
Если значение не указано в задаче, будет использовано значение переменной окружения ACI_USE_PROXY.
use_ssl
булево
    Варианты:
  • no
  • yes ←
Если no, вместо стандартного подключения HTTPS будет использоваться HTTP-соединение.
Если значение не указано в задаче, будет использовано значение переменной окружения ACI_USE_SSL.
username
строка
Значение по умолчанию:
"admin"
Имя пользователя для аутентификации.
Если значение не указано в задаче, будут использованы значения переменных окружения ACI_USERNAME или ANSIBLE_NET_USERNAME.

псевдонимы: user
validate_certs
булево
    Варианты:
  • no
  • yes ←
Если no, сертификаты SSL не будут проверены.
Это следует установить в no только при работе с сайтами, контролируемыми лично, которые используют самозаверяющие сертификаты.
Если значение не указано в задаче, будет использовано значение переменной окружения ACI_VALIDATE_CERTS.

См. также

См. также

Ссылка на модель управления информацией APIC

Дополнительная информация об внутренней классе APIC lacp:LagPol.

Руководство Cisco ACI

Подробная информация о том, как управлять инфраструктурой ACI с помощью Ansible.

Разработка модулей Cisco ACI

Подробное руководство по написанию собственных модулей Cisco ACI для внесения вклада.

Примеры

- name: Add a port channel interface policy
  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
строка
ошибка разбора
Необработанный вывод, возвращенный 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


Авторы

  • Dag Wieers (@dagwieers)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/cisco/aci/aci_interface_policy_port_channel_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API