Установка и настройка / Основные элементы АппОптима / АппОптима / REST API / API Кластера v1 / Пользователи / Удаление пользователя
Этот вызов API удаляет пользователя кластера.
Аутентификация
Для выполнения этого запроса вам необходимо разрешение API (ServiceProviderAPI)
, назначенное вашему токену API. Создайте свой токен API с помощью консоли управления кластером (CMC). Чтобы узнать, как его получить и использовать, см. Аутентификация кластера.
Конечная точка
/api/v1.0/onpremise/users
Параметры
Параметр | Тип | Описание | В | Обязательно |
---|---|---|---|---|
id | string | Параметр пути идентификатора пользователя. Отсутствующие или пустые значения вернут «Bad Request». | path | Да |
Ответ
Коды ответа
Код | Тип | Описание |
---|---|---|
200 | UserConfig | Пользователь успешно удалён |
304 | Пользователь не удалён | |
400 | Информация об ID пользователя не получена для запроса на удаление пользователя | |
406 | Недопустимый запрос |
Объекты тела ответа
Объект 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
. Если учетная запись пользователя удалена, вы получите сведения об удаленном пользователе. Если пользователь был удален ранее, вы получите пустую полезную нагрузку ответа с кодом 200
.
Curl
curl -X DELETE "https://myАппОптима.cluster.com/api/v1.0/onpremise/users/john.wicked" -H "accept: application/json"
URL-адрес запроса
https://myАппОптима.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