Получение информации о пользователе

Установка и настройка / Основные элементы Ключ-Астром / Ключ-АСТРОМ Managed / REST API / API Кластера v1 / Пользователи / Получение информации о пользователе

Этот вызов API извлекает информацию о конкретном пользователе кластера.

Аутентификация

Для выполнения этого запроса вам необходимо разрешение API (ServiceProviderAPI), назначенное вашему токену API. Создайте свой токен API с помощью консоли управления кластером (CMC). Чтобы узнать, как его получить и использовать, см. Аутентификация кластера.

Конечная точка

/api/v1.0/onpremise/users

Параметры

Параметр	Тип	Описание	В	Обязательно
id	string	Параметр пути идентификатора пользователя. Отсутствующие или пустые значения вернут «Bad Request».	path	Да

Ответ

Коды ответа

Код	Тип	Описание
200	UserConfig[]	Успех
400		Информация об идентификаторе не получена для запроса на получение пользователя
404		Не найдено

Объекты тела ответа

Объект UserConfig

Конфигурация пользователя.

Элемент	Тип	Описание
id	string	ID пользователя
email	string	Адрес электронной почты пользователя
firstName	string	Имя пользователя
lastName	string	Фамилия пользователя
passwordClearText	string	Пароль пользователя открытым текстом; используется только для установки начального пароля
groups	string[]	Список идентификаторов групп пользователей пользователя.

JSON-модель тела ответа

{
  "id": "string",
  "email": "string",
  "firstName": "string",
  "lastName": "string",
  "passwordClearText": "string",
  "groups": [
    "string"
  ]
}

Пример

В этом примере вы получаете информацию о пользователе john.wicked.

Curl

curl -X GET "https://myManaged.cluster.com/api/v1.0/onpremise/users/john.wicked" -H  "accept: application/json"

URL-адрес запроса

https://mymanaged.cluster.com/api/v1.0/onpremise/users/john.wicked

Тело ответа

{
    "id": "john.wicked",
    "email": "john.wicked@company.com",
    "firstName": "John",
    "lastName": "Wicked",
    "passwordClearText": null,
    "groups": [
      "admin"
    ]
}

Код ответа

200