модуль cisco.intersight.intersight_link_control_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_control_policy.

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

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

Управляет настройкой политики управления каналом связи в Cisco Intersight.
Политика для настройки параметров UDLD (обнаружение однонаправленного канала) на устройствах под управлением 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), дефис (-), точку (.), двоеточие (:) или символ подчеркивания (_).
name string / обязательный	Имя, присвоенное политике управления каналом связи. Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_.
organization string	Имя организации, которой назначен этот ресурс. Профили, политики и пулы, созданные в пользовательской организации, применимы только к устройствам в этой же организации. По умолчанию: `"default"`
state string	Если задано `present`, проверяется наличие ресурса и при необходимости он создается. Если задано `absent`, проверяется отсутствие ресурса и при необходимости он удаляется. Варианты: `"present"` ← (по умолчанию) `"absent"`
tags list / элементы=dictionary	Список тегов в формате «Ключ:<ключ, заданный пользователем> Значение:<значение, заданное пользователем>».
udld_admin_state string	Настроенное административное состояние канала UDLD для этого порта. Варианты: `"Enabled"` ← (по умолчанию) `"Disabled"`
udld_mode string	Настроенный административный режим UDLD для этого порта. Нельзя задать значение ‘aggressive’, если для udld_admin_state указано значение ‘Disabled’. Варианты: `"normal"` ← (по умолчанию) `"aggressive"`
use_proxy boolean	Если задано `no`, прокси не используется, даже если он указан в переменной окружения на целевых хостах. Варианты: `false` `true` ← (по умолчанию)
validate_certs boolean	Логический параметр управления проверкой TLS-сертификата api_uri. Варианты: `false` `true` ← (по умолчанию)

Примеры

- name: Configure Link Control Policy with UDLD enabled in aggressive mode
  cisco.intersight.intersight_link_control_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "test-link-aggressive"
    description: "Link Control Policy with aggressive UDLD"
    udld_admin_state: "Enabled"
    udld_mode: "aggressive"
    tags:
      - Key: Site
        Value: DataCenter-A

- name: Configure Link Control Policy with UDLD disabled
  cisco.intersight.intersight_link_control_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "test-link-disabled"
    description: "Link Control Policy with UDLD disabled"
    udld_admin_state: "Disabled"
    udld_mode: "normal"

- name: Delete Link Control Policy
  cisco.intersight.intersight_link_control_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "test-link-policy"
    state: absent

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

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

Ключ	Описание
api_response dictionary	Данные ответа API, возвращенные указанным ресурсом. Возвращается: всегда Пример: `{"api_response": {"Name": "test-link-policy", "ObjectType": "fabric.LinkControlPolicy", "Tags": [{"Key": "Site", "Value": "DataCenter-A"}], "UdldSettings": {"AdminState": "Enabled", "ClassId": "fabric.UdldSettings", "Mode": "aggressive", "ObjectType": "fabric.UdldSettings"}}}`

Ключ

Описание

api_response

dictionary

Данные ответа API, возвращенные указанным ресурсом.

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

Пример: {"api_response": {"Name": "test-link-policy", "ObjectType": "fabric.LinkControlPolicy", "Tags": [{"Key": "Site", "Value": "DataCenter-A"}], "UdldSettings": {"AdminState": "Enabled", "ClassId": "fabric.UdldSettings", "Mode": "aggressive", "ObjectType": "fabric.UdldSettings"}}}

Авторы

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_control_policy_module.html