Модуль cisco.dnac.user_info – Модуль информации для пользователя
Примечание
Этот модуль является частью коллекции cisco.dnac (версия 6.20.0).
У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.dnac. Для использования этого модуля требуются дополнительные зависимости, см. Требования для получения подробностей.
Для использования в книге задач укажите: cisco.dnac.user_info.
Новое в cisco.dnac 3.1.0
Обзор
- Получение всех пользователей.
- Получение всех пользователей для системы Cisco DNA Center.
Примечание
У этого модуля есть соответствующий плагин действия.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- dnacentersdk >= 2.7.2
- python >= 3.5
Параметры
Параметр | Комментарии |
|---|---|
authSource строка | Параметр запроса authSource. Источник, аутентифицирующий пользователя. Значение этого параметра запроса может быть установлено в «internal» или «external». Если не указано, то во всех ответах будут возвращены все пользователи. |
dnac_debug логический | Флаг для Cisco DNA Center SDK для включения отладки. Варианты:
|
dnac_host строка / обязательный | Имя хоста Cisco DNA Center. |
dnac_password строка | Пароль Cisco DNA Center для аутентификации. |
dnac_port целое число | Порт Cisco DNA Center. По умолчанию: |
dnac_username псевдонимы: user строка | Имя пользователя Cisco DNA Center для аутентификации. По умолчанию: |
dnac_verify логический | Флаг для включения или выключения проверки сертификата SSL. Варианты:
|
dnac_version строка | Уведомляет SDK, какую версию Cisco DNA Center использовать. По умолчанию: |
headers словарь | Дополнительные заголовки. |
invokeSource строка | Параметр запроса invokeSource. Источник, вызывающий этот API. Значение этого параметра запроса должно быть установлено в «external». |
validate_response_schema логический | Флаг для Cisco DNA Center SDK для включения проверки тел запросов на соответствие JSON-схеме. Варианты:
|
Примечания
Примечание
- Используемые методы SDK: user_and_roles.UserandRoles.get_users_api,
- Используемые пути: get /dna/system/api/v1/user,
- Поддерживает
check_mode - Плагин выполняется на узле управления и не использует плагины подключения Ansible, а вместо этого использует встроенный диспетчер подключений Cisco DNAC SDK
- Параметры, начинающиеся с dnac_, используются Cisco DNAC Python SDK для установления соединения
См. также
См. также
- Документация Cisco DNA Center по пользователям и ролям GetUsersAPI
-
Полная справка по API GetUsersAPI.
Примеры
- name: Get all User
cisco.dnac.user_info:
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}}"
headers: "{{my_headers | from_json}}"
invokeSource: string
authSource: string
register: result
Значения возврата
Общие значения возврата описаны в этом разделе, а следующие являются полями, уникальными для этого модуля:
Ключ | Описание |
|---|---|
dnac_response словарь | Словарь или список с ответом, возвращенным Cisco DNAC Python SDK Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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/user_info_module.html