Модуль cisco.intersight.intersight_device_connector_policy — настройка политики Device Connector для Cisco Intersight

Примечание

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

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

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

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

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

Описание

Управляет настройкой политики Device Connector в Cisco Intersight.
Политика для настройки параметров Device Connector на устройствах, управляемых 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	Описание политики Device Connector, заданное пользователем. Описание может содержать буквы (a-z, A-Z), цифры (0-9), дефис (-), точку (.), двоеточие (:) или символ подчёркивания (_).
enable_lockout boolean	Включает блокировку конфигурации на конечном устройстве. При включении предотвращает локальное изменение конфигурации устройства через интерфейсы IMC или CIMC. Блокировка гарантирует, что все изменения конфигурации выполняются через Intersight. Варианты: `false` ← (по умолчанию) `true`
name string / обязательный	Имя, присвоенное политике Device Connector. Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_.
organization string	Имя организации, которой назначен этот ресурс. Профили и политики, созданные в пользовательской организации, применимы только к устройствам в той же организации. По умолчанию: `"default"`
state string	Если `present`, будет проверено наличие ресурса, и при необходимости он будет создан. Если `absent`, будет проверено отсутствие ресурса, и при необходимости он будет удалён. Варианты: `"present"` ← (по умолчанию) `"absent"`
tags list / элементы=dictionary	Список тегов в формате Key:<ключ, заданный пользователем> Value:<значение, заданное пользователем>. По умолчанию: `[]`
use_proxy boolean	Если `no`, прокси использоваться не будет, даже если он задан в переменной окружения на целевых узлах. Варианты: `false` `true` ← (по умолчанию)
validate_certs boolean	Логический параметр для проверки TLS-сертификата api_uri Варианты: `false` `true` ← (по умолчанию)

Примеры

- name: Create Device Connector Policy with lockout enabled
  cisco.intersight.intersight_device_connector_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "device-connector-lockout-policy"
    description: "Device connector policy with lockout enabled"
    enable_lockout: true
    tags:
      - Key: "Environment"
        Value: "Production"
    state: present

- name: Create Device Connector Policy with lockout disabled
  cisco.intersight.intersight_device_connector_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "device-connector-no-lockout-policy"
    description: "Device connector policy with lockout disabled"
    enable_lockout: false
    state: present

- name: Update existing Device Connector Policy
  cisco.intersight.intersight_device_connector_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "device-connector-lockout-policy"
    description: "Updated device connector policy"
    enable_lockout: false
    state: present

- name: Delete Device Connector Policy
  cisco.intersight.intersight_device_connector_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "device-connector-lockout-policy"
    state: absent

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

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

Ключ	Описание
api_response dictionary	Выходные данные ответа API, возвращённые для указанного ресурса. Возвращается: всегда Пример: `{"api_response": {"Description": "Device connector policy with lockout enabled", "LockoutEnabled": true, "Name": "device-connector-lockout-policy", "ObjectType": "deviceconnector.Policy", "Organization": {"Moid": "675450ee69726530014753e2", "ObjectType": "organization.Organization"}, "Tags": [{"Key": "Environment", "Value": "Production"}]}}`

Ключ

Описание

api_response

dictionary

Выходные данные ответа API, возвращённые для указанного ресурса.

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

Пример: {"api_response": {"Description": "Device connector policy with lockout enabled", "LockoutEnabled": true, "Name": "device-connector-lockout-policy", "ObjectType": "deviceconnector.Policy", "Organization": {"Moid": "675450ee69726530014753e2", "ObjectType": "organization.Organization"}, "Tags": [{"Key": "Environment", "Value": "Production"}]}}

Авторы

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