ENetrebin (обсуждение | вклад) Нет описания правки |
Нет описания правки |
||
| (не показаны 2 промежуточные версии этого же участника) | |||
| Строка 1: | Строка 1: | ||
'''''[ | '''''[[Установка и настройка]] / [[Установка и настройка|Основные элементы АппОптима]] / [[АппОптима]] / [[АппОптима|REST API]] / [[API Кластера v1]] / [[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> | ||
| Строка 76: | Строка 76: | ||
|} | |} | ||
===JSON-модель тела ответа=== | ===JSON-модель тела ответа=== | ||
< | <{ | ||
"id": "string", | "id": "string", | ||
"email": "string", | "email": "string", | ||
| Строка 85: | Строка 85: | ||
"string" | "string" | ||
] | ] | ||
} | } | ||
==Пример== | ==Пример== | ||
В этом примере вы удалите учетную запись пользователя <code>john.wicked</code>. Если учетная запись пользователя удалена, вы получите сведения об удаленном пользователе. Если пользователь был удален ранее, вы получите пустую полезную нагрузку ответа с кодом <code>200</code>. | В этом примере вы удалите учетную запись пользователя <code>john.wicked</code>. Если учетная запись пользователя удалена, вы получите сведения об удаленном пользователе. Если пользователь был удален ранее, вы получите пустую полезную нагрузку ответа с кодом <code>200</code>. | ||
====Curl==== | ====Curl==== | ||
<code>curl -X DELETE "<nowiki>https:// | <code>curl -X DELETE "<nowiki>https://myАппОптима.cluster.com/api/v1.0/onpremise/users/john.wicked</nowiki>" -H "accept: application/json"</code> | ||
====URL-адрес запроса==== | ====URL-адрес запроса==== | ||
<code><nowiki>https:// | <code><nowiki>https://myАппОптима.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", | ||
| Строка 102: | Строка 102: | ||
"admin" | "admin" | ||
] | ] | ||
} | } | ||
====Код ответа==== | ====Код ответа==== | ||
<code>200</code> | <code>200</code> | ||
Текущая версия от 15:55, 6 января 2025
Установка и настройка / Основные элементы АппОптима / АппОптима / 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