модуль cisco.intersight.intersight_link_aggregation_policy — настройка политики агрегирования каналов для Cisco Intersight

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: cisco.intersight.intersight_link_aggregation_policy.

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

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

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

Параметры

Параметр	Комментарии
api_key_id string / обязательный	Идентификатор общедоступного API-ключа, связанного с закрытым ключом. Если значение не задано, используется значение переменной окружения INTERSIGHT_API_KEY_ID.
api_private_key path / обязательный	Имя файла (абсолютный путь) или строка с данными закрытого ключа в формате PEM, используемого для аутентификации в API Intersight. Если используется строка, для шифрования строковых данных следует использовать Ansible Vault. Например: ansible-vault encrypt_string --vault-id tme@/Users/dsoper/Documents/vault_password_file ‘-----BEGIN EC PRIVATE KEY----- <your private key data> -----END EC PRIVATE KEY-----’ Если значение не задано, используется значение переменной окружения INTERSIGHT_API_PRIVATE_KEY.
api_uri string	URI для доступа к API Intersight. Если значение не задано, используется значение переменной окружения INTERSIGHT_API_URI. По умолчанию: `"https://intersight.com/api/v1"`
description псевдонимы: descr string	Описание политики агрегирования каналов, заданное пользователем. Описание может содержать буквы (a-z, A-Z), цифры (0-9), дефис (-), точку (.), двоеточие (:) или знак подчёркивания (_).
lacp_rate string	Флаг, указывающий, следует ли отправлять PDU LACP с высокой частотой («быстро»), то есть каждую секунду. `normal` — PDU LACP отправляются каждые 30 секунд. `fast` — PDU LACP отправляются каждую секунду. Допустимые значения: `"normal"` ← (по умолчанию) `"fast"`
name string / обязательный	Имя, присвоенное политике агрегирования каналов. Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_.
organization string	Имя организации, которой назначен этот ресурс. Профили, политики и пулы, созданные в пользовательской организации, применимы только к устройствам этой же организации. По умолчанию: `"default"`
state string	Если задано значение `present`, проверяется наличие ресурса и при необходимости он создаётся. Если задано значение `absent`, проверяется отсутствие ресурса и при необходимости он удаляется. Допустимые значения: `"present"` ← (по умолчанию) `"absent"`
suspend_individual boolean	Флаг, указывающий коммутатору, следует ли приостанавливать порт, если он не получил PDU LACP. Если этот параметр включён, коммутатор приостановит порт в агрегированном канале, если PDU LACP не будут получены. Допустимые значения: `false` ← (по умолчанию) `true`
tags list / элементы=dictionary	Список тегов в формате «Ключ:<заданный пользователем ключ> Значение:<заданное пользователем значение>».
use_proxy boolean	Если задано значение `no`, прокси-сервер использоваться не будет, даже если он указан в переменной окружения на целевых узлах. Допустимые значения: `false` `true` ← (по умолчанию)
validate_certs boolean	Логический параметр для проверки TLS-сертификата api_uri. Допустимые значения: `false` `true` ← (по умолчанию)

Примеры

- name: Create a Link Aggregation Policy with default settings
  cisco.intersight.intersight_link_aggregation_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "LinkAgg-Policy-01"
    description: "Link aggregation policy with default LACP settings"
    tags:
      - Key: "Site"
        Value: "DataCenter-A"
    state: present

- name: Create a Link Aggregation Policy with fast LACP rate
  cisco.intersight.intersight_link_aggregation_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "LinkAgg-Fast-Policy"
    description: "Link aggregation policy with fast LACP rate"
    lacp_rate: fast
    suspend_individual: true
    state: present

- name: Create a Link Aggregation Policy with normal LACP rate and suspend individual disabled
  cisco.intersight.intersight_link_aggregation_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "LinkAgg-Normal-Policy"
    lacp_rate: normal
    suspend_individual: false
    state: present

- name: Update a Link Aggregation Policy
  cisco.intersight.intersight_link_aggregation_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "LinkAgg-Policy-01"
    description: "Updated link aggregation policy"
    lacp_rate: fast
    suspend_individual: true
    state: present

- name: Delete a Link Aggregation Policy
  cisco.intersight.intersight_link_aggregation_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "LinkAgg-Policy-01"
    state: absent

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

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

Ключ	Описание
api_response dictionary	Результат ответа API, возвращённый для указанного ресурса. Возвращается: всегда Пример: `{"api_response": {"LacpRate": "normal", "Name": "LinkAgg-Policy-01", "ObjectType": "fabric.LinkAggregationPolicy", "SuspendIndividual": false, "Tags": [{"Key": "Site", "Value": "DataCenter-A"}]}}`

Авторы

Ron Gershburg (@rgershbu)

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

© 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/intersight/intersight_link_aggregation_policy_module.html