Spec-Zone.ru › Ansible

Модуль cisco.aci.aci_vmm_enhanced_lag_policy — управление политикой Enhanced LACP для Virtual Machine Manager (VMM) в Cisco ACI (lacp:EnhancedLagPol)

Примечание

Этот модуль входит в коллекцию cisco.aci (версия 2.13.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

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

Чтобы использовать коллекцию в плейбуке, укажите: cisco.aci.aci_vmm_enhanced_lag_policy.

Добавлено в cisco.aci 2.12.0

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

Краткое описание

  • Управление политикой Enhanced LACP для доменов VMM в фабриках Cisco ACI.
  • Политика Enhanced LACP позволяет настраивать дополнительные параметры протокола управления агрегацией каналов (LACP) для виртуальных коммутаторов в доменах VMM.

Параметры

Параметр

Комментарии

annotation

string

Строка, заданная пользователем для аннотирования объекта.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения ACI_ANNOTATION.

Если значение не указано в задаче и переменная окружения ACI_ANNOTATION, будет использовано значение по умолчанию.

По умолчанию: "orchestrator:ansible"

certificate_name

псевдонимы: cert_name

string

Имя сертификата X.509, связанного с пользователем APIC AAA, который используется для аутентификации на основе подписи.

Если указано имя файла private_key, по умолчанию используется имя файла private_key без расширения.

Если для private_key указано содержимое в формате PEM, по умолчанию используется значение username.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения ACI_CERTIFICATE_NAME.

domain

псевдонимы: domain_name, domain_profile

string

Имя профиля виртуального домена, к которому применяется политика Enhanced LACP.

host

псевдоним: hostname

string

IP-адрес или имя хоста APIC, доступное для разрешения на управляющем узле Ansible.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения ACI_HOST.

lacp_mode

string

Режим LACP для политики.

Определяет, инициирует ли политика согласование LACP или отвечает на него.

Если при создании параметр не задан, APIC использует значение active.

Варианты:

  • "active"
  • "passive"

load_balancing_mode

string

Алгоритм балансировки нагрузки для распределения трафика по каналам в агрегированном канале.

Подробную информацию см. в справочнике APIC Management Information Model.

Если при создании параметр не задан, APIC использует значение src-dst-ip.

Варианты:

  • "dst-ip"
  • "dst-ip-l4port"
  • "dst-ip-vlan"
  • "dst-ip-l4port-vlan"
  • "dst-mac"
  • "dst-l4port"
  • "src-ip"
  • "src-ip-l4port"
  • "src-ip-vlan"
  • "src-ip-l4port-vlan"
  • "src-mac"
  • "src-l4port"
  • "src-dst-ip"
  • "src-dst-ip-l4port"
  • "src-dst-ip-vlan"
  • "src-dst-ip-l4port-vlan"
  • "src-dst-mac"
  • "src-dst-l4port"
  • "src-port-id"
  • "vlan"

name

string

Имя политики Enhanced LACP.

number_uplinks

integer

Минимальное количество восходящих каналов, необходимое для агрегированного канала.

Значение должно быть в диапазоне от 2 до 8.

Если при создании параметр не задан, APIC использует значение 2.

output_level

string

Настраивает вывод этого модуля ACI.

normal означает стандартный вывод, включая словарь current.

info добавляет информационный вывод, включая previous, proposed и словари sent.

debug добавляет отладочный вывод, включая сведения filter_string, method, response, status и url.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения ACI_OUTPUT_LEVEL.

Варианты:

  • "debug"
  • "info"
  • "normal" ← (по умолчанию)

output_path

string

Путь к файлу, в который будут записываться созданные модулем объекты конфигурации ACI в формате JSON.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения ACI_OUTPUT_PATH.

owner_key

string

Строка, заданная пользователем для атрибута ownerKey объекта ACI.

Этот атрибут представляет собой ключ, позволяющий клиентам владеть своими данными для сопоставления сущностей.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения ACI_OWNER_KEY.

owner_tag

string

Строка, заданная пользователем для атрибута ownerTag объекта ACI.

Этот атрибут представляет собой тег, позволяющий клиентам добавлять собственные данные.

Например, чтобы указать, кто создал этот объект.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения ACI_OWNER_TAG.

password

string

Пароль для аутентификации.

Этот параметр несовместим с private_key. Если также задан private_key, будет использоваться именно он.

Если значение не указано в задаче, вместо него будут использованы переменные окружения ACI_PASSWORD или ANSIBLE_NET_PASSWORD.

port

integer

Номер порта для REST-подключения.

Значение по умолчанию зависит от параметра use_ssl.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения ACI_PORT.

private_key

псевдоним: cert_key

string

Файл закрытого ключа в формате PEM или содержимое закрытого ключа, используемое для аутентификации на основе подписи.

Это значение также влияет на используемое значение certificate_name по умолчанию.

Этот параметр несовместим с password. Если также задан password, он будет проигнорирован.

Если значение не указано в задаче, вместо него будут использованы переменные окружения ACI_PRIVATE_KEY или ANSIBLE_NET_SSH_KEYFILE.

state

string

Требуемое состояние политики Enhanced LACP.

Используйте present для создания или обновления политики.

Используйте absent для удаления политики.

Используйте query для получения сведений о политике.

Варианты:

  • "absent"
  • "present" ← (по умолчанию)
  • "query"

suppress_previous

псевдонимы: no_previous, ignore_previous

boolean

Если true, перед POST-обновлением APIC не будет отправлен GET-запрос для проверки предыдущего состояния.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения ACI_SUPPRESS_PREVIOUS.

Значение по умолчанию — false.

ПРЕДУПРЕЖДЕНИЕ — в результате возвращаемое значение previous будет пустым.

Предыдущее состояние объекта проверяться не будет, а POST-запрос обновления будет содержать все свойства.

Варианты:

  • false
  • true

suppress_verification

псевдонимы: no_verification, no_verify, suppress_verify, ignore_verify, ignore_verification

boolean

Если true, после POST-обновления APIC не будет отправлен проверочный GET-запрос.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения ACI_SUPPRESS_VERIFICATION.

Значение по умолчанию — false.

ПРЕДУПРЕЖДЕНИЕ — в результате возвращаемое значение current будет установлено в предложенное значение.

Текущий объект, включая значения по умолчанию, нельзя будет проверить в рамках одной задачи.

Варианты:

  • false
  • true

timeout

integer

Тайм-аут на уровне сокета, в секундах.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения ACI_TIMEOUT.

Значение по умолчанию — 30.

use_proxy

boolean

Если false, прокси использоваться не будет, даже если он задан в переменной окружения на целевых узлах.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения ACI_USE_PROXY.

Значение по умолчанию — true.

Варианты:

  • false
  • true

use_ssl

boolean

Если false, вместо подключения HTTPS по умолчанию будет использоваться подключение HTTP.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения ACI_USE_SSL.

Значение по умолчанию — true при локальном подключении.

Варианты:

  • false
  • true

username

псевдоним: user

string

Имя пользователя для аутентификации.

Если значение не указано в задаче, вместо него будут использованы переменные окружения ACI_USERNAME или ANSIBLE_NET_USERNAME.

Значение по умолчанию — admin.

validate_certs

boolean

Если false, SSL-сертификаты не будут проверяться.

Устанавливайте значение false только для контролируемых вами сайтов, использующих самоподписанные сертификаты.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения ACI_VALIDATE_CERTS.

Значение по умолчанию — true.

Варианты:

  • false
  • true

vm_provider

string

Поставщик платформы виртуализации для домена VMM.

Варианты:

  • "cloudfoundry"
  • "kubernetes"
  • "microsoft"
  • "openshift"
  • "openstack"
  • "redhat"
  • "vmware"

Примечания

Примечание

  • Перед использованием этого модуля в плейбуке необходимо создать vmm_domain и vSwitch_policy.
  • Для этого можно использовать модули cisco.aci.aci_domain и cisco.aci.aci_vmm_vswitch_policy.

См. также

См. также

cisco.aci.aci_domain

Управление профилями физических, виртуальных, мостовых, маршрутизируемых доменов или доменов FC (phys:DomP, vmm:DomP, l2ext:DomP, l3ext:DomP и fc:DomP).

cisco.aci.aci_vmm_vswitch_policy

Управление политикой vSwitch для профилей виртуальных доменов VMware (vmm:VSwitchPolicyCont).

Справочник APIC Management Information Model

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

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

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

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

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

Примеры

- name: Create an Enhanced LACP Policy
  cisco.aci.aci_vmm_enhanced_lag_policy:
    host: apic.example.com
    username: admin
    password: SomeSecretPassword
    name: my_enhanced_lag_policy
    domain: my_vmm_domain
    vm_provider: vmware
    lacp_mode: active
    load_balancing_mode: src-dst-ip
    number_uplinks: 4
    state: present

- name: Update an existing Enhanced LACP Policy
  cisco.aci.aci_vmm_enhanced_lag_policy:
    host: apic.example.com
    username: admin
    password: SomeSecretPassword
    name: my_enhanced_lag_policy
    domain: my_vmm_domain
    vm_provider: vmware
    lacp_mode: passive
    load_balancing_mode: src-dst-ip-l4port
    number_uplinks: 6
    state: present

- name: Query a specific Enhanced LACP Policy
  cisco.aci.aci_vmm_enhanced_lag_policy:
    host: apic.example.com
    username: admin
    password: SomeSecretPassword
    name: my_enhanced_lag_policy
    domain: my_vmm_domain
    vm_provider: vmware
    state: query
  register: query_result

- name: Query all Enhanced LACP Policies in a VMM domain
  cisco.aci.aci_vmm_enhanced_lag_policy:
    host: apic.example.com
    username: admin
    password: SomeSecretPassword
    domain: my_vmm_domain
    vm_provider: vmware
    state: query
  register: query_all_result

- name: Delete an Enhanced LACP Policy
  cisco.aci.aci_vmm_enhanced_lag_policy:
    host: apic.example.com
    username: admin
    password: SomeSecretPassword
    name: my_enhanced_lag_policy
    domain: my_vmm_domain
    vm_provider: vmware
    state: absent

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ

Описание

current

list / элементы=string

Текущая конфигурация политики Enhanced LACP из APIC после завершения работы модуля.

Возвращается: success

Пример: [{"lacpEnhancedLagPol": {"attributes": {"dn": "uni/vmmp-VMware/dom-test_vmm_dom/vswitchpolcont/enlacplagp-test_enhanced_lag_policy", "lbmode": "src-dst-ip", "mode": "active", "name": "test_enhanced_lag_policy", "numLinks": "4"}}}]

error

dictionary

Сведения об ошибке, возвращённые APIC.

Возвращается: failure

Пример: {"code": "801", "text": "property name of enlacplagp-test_enhanced_lag_policy failed validation"}

proposed

dictionary

Конфигурация, отправленная в APIC.

Возвращается: info

Пример: {"lacpEnhancedLagPol": {"attributes": {"lbmode": "src-dst-ip", "mode": "active", "name": "test_enhanced_lag_policy", "numLinks": "4"}}}

Авторы

  • Dev Sinha (@DevSinha13)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)

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

Spec-Zone.ru

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