ENetrebin (обсуждение | вклад) Нет описания правки |
Нет описания правки |
||
| Строка 1: | Строка 1: | ||
''''' | '''''Установка и настройка / Основные элементы АппОптима / АппОптима Managed / REST API / API Кластера v1 / Пользователи / Получение информации о пользователе''''' | ||
Этот вызов API извлекает информацию о конкретном пользователе кластера. | Этот вызов API извлекает информацию о конкретном пользователе кластера. | ||
==Аутентификация== | ==Аутентификация== | ||
Для выполнения этого запроса вам необходимо разрешение API <code>(ServiceProviderAPI)</code>, назначенное вашему токену API. Создайте свой токен API с помощью консоли управления кластером (CMC). Чтобы узнать, как его получить и использовать, см. | Для выполнения этого запроса вам необходимо разрешение API <code>(ServiceProviderAPI)</code>, назначенное вашему токену API. Создайте свой токен API с помощью консоли управления кластером (CMC). Чтобы узнать, как его получить и использовать, см. Аутентификация кластера. | ||
==Конечная точка== | ==Конечная точка== | ||
<code>/api/v1.0/onpremise/users</code> | <code>/api/v1.0/onpremise/users</code> | ||
| Строка 73: | Строка 73: | ||
|} | |} | ||
===JSON-модель тела ответа=== | ===JSON-модель тела ответа=== | ||
< | <{ | ||
"id": "string", | "id": "string", | ||
"email": "string", | "email": "string", | ||
| Строка 90: | Строка 90: | ||
<code><nowiki>https://mymanaged.cluster.com/api/v1.0/onpremise/users/john.wicked</nowiki></code> | <code><nowiki>https://mymanaged.cluster.com/api/v1.0/onpremise/users/john.wicked</nowiki></code> | ||
====Тело ответа==== | ====Тело ответа==== | ||
< | <{ | ||
"id": "john.wicked", | "id": "john.wicked", | ||
"email": "john.wicked@company.com", | "email": "john.wicked@company.com", | ||
Версия от 13:24, 8 ноября 2024
Установка и настройка / Основные элементы АппОптима / АппОптима 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 пользователя |
| 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