Удаление пользователя

Материал из Документация Ключ-АСТРОМ

Установка и настройка / Основные элементы Ключ-Астром / Ключ-АСТРОМ Managed / 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 пользователя
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. Если учетная запись пользователя удалена, вы получите сведения об удаленном пользователе. Если пользователь был удален ранее, вы получите пустую полезную нагрузку ответа с кодом 200.

Curl

curl -X DELETE "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