Модуль cisco.dnac.device_credential_update — Модуль ресурсов для обновления данных устройства

Примечание

Этот модуль входит в состав коллекции cisco.dnac (версия 6.20.0).

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

Для установки используйте: ansible-galaxy collection install cisco.dnac. Для использования этого модуля требуются дополнительные условия, см. Требования для получения подробностей.

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

Добавлен в cisco.dnac 3.1.0

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

Обзор

Управление операцией обновления ресурса «Обновление данных устройства».
API для обновления учетных данных устройства. Этот API устарел и не будет доступен в релизах Cisco DNA Center после 1 августа 2024 г. 23:59:59 по Гринвичу. Обратитесь к новому API Intent для обновления глобальных учетных данных версии 2.

Примечание

Для этого модуля имеется соответствующий плагин действий.

Требования

Ниже перечислены требования, необходимые на хосте, который выполняет этот модуль.

dnacentersdk >= 2.7.2
python >= 3.5

Параметры

Параметр	Комментарии
dnac_debug boolean	Флаг для Cisco DNA Center SDK, позволяющий включить отладку. Варианты: `false` ← (по умолчанию) `true`
dnac_host string / обязательно	Имя хоста Cisco DNA Center.
dnac_password string	Пароль для аутентификации в Cisco DNA Center.
dnac_port integer	Порт Cisco DNA Center. По умолчанию: `443`
dnac_username псевдонимы: user string	Имя пользователя Cisco DNA Center для аутентификации. По умолчанию: `"admin"`
dnac_verify boolean	Флаг для включения или отключения проверки сертификата SSL. Варианты: `false` `true` ← (по умолчанию)
dnac_version string	Указывает SDK, какую версию Cisco DNA Center использовать. По умолчанию: `"2.3.7.6"`
settings словарь	Настройки модуля обновления данных об учетных записях устройств.
cliCredential словарь	cliCredential для обновления данных об учетных записях устройств.
description string	Описание.
enablePassword string	Пароль для включения.
id string	Идентификатор.
password string	Пароль.
username string	Имя пользователя.
httpsRead словарь	httpsRead для обновления данных об учетных записях устройств.
id string	Идентификатор.
name string	Имя.
password string	Пароль.
port string	Порт.
username string	Имя пользователя.
httpsWrite словарь	httpsWrite для обновления данных об учетных записях устройств.
id string	Идентификатор.
name string	Имя.
password string	Пароль.
port string	Порт.
username string	Имя пользователя.

snmpV2cRead словарь	snmpV2cRead модуля обновления учетных данных устройства.
description строка	Описание.
id строка	Идентификатор.
readCommunity строка	Сообщество чтения.
snmpV2cWrite словарь	snmpV2cWrite модуля обновления учетных данных устройства.
description строка	Описание.
id строка	Идентификатор.
writeCommunity строка	Сообщество записи.
snmpV3 словарь	snmpV3 модуля обновления учетных данных устройства.
authPassword строка	Пароль аутентификации.
authType строка	Тип аутентификации.
description строка	Описание.
id строка	Идентификатор.
privacyPassword строка	Пароль конфиденциальности.
privacyType строка	Тип конфиденциальности.
snmpMode строка	Режим SNMP.
username строка	Имя пользователя.
validate_response_schema булево	Флаг для Cisco DNA Center SDK, который включает проверку тел запросов по схеме JSON. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Используемый метод SDK — network_settings.NetworkSettings.update_device_credentials,
Используемые пути — put /dna/intent/api/v1/device-credential,
Не поддерживает check_mode
Плагин работает на узле управления и не использует плагины подключения ansible, а вместо этого использует встроенный менеджер подключений Cisco DNAC SDK
Параметры, начинающиеся с dnac_, используются Cisco DNAC Python SDK для установления соединения

См. также

Документация Cisco DNA Center по обновлению настроек сети UpdateDeviceCredentials: Полное описание API UpdateDeviceCredentials.

Примеры

- name: Update all
  cisco.dnac.device_credential_update:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    settings:
      cliCredential:
        description: string
        enablePassword: string
        id: string
        password: string
        username: string
      httpsRead:
        id: string
        name: string
        password: string
        port: string
        username: string
      httpsWrite:
        id: string
        name: string
        password: string
        port: string
        username: string
      snmpV2cRead:
        description: string
        id: string
        readCommunity: string
      snmpV2cWrite:
        description: string
        id: string
        writeCommunity: string
      snmpV3:
        authPassword: string
        authType: string
        description: string
        id: string
        privacyPassword: string
        privacyType: string
        snmpMode: string
        username: string

Значения возврата

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

Ключ	Описание
dnac_response словарь	Словарь или список, содержащий ответ, возвращенный Cisco DNAC Python SDK Возвращается: всегда Пример: `{"executionId": "string", "executionStatusUrl": "string", "message": "string"}`

Авторы

Rafael Campos (@racampos)

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

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