Установка и настройка / Основные элементы АппОптима / АппОптима / REST API / API Кластера v1 / Политика паролей / Обновление политики паролей кластера
Этот вызов API обновляет политику паролей кластера.
Аутентификация
Для выполнения этого запроса вам необходимо разрешение API (ServiceProviderAPI), назначенное вашему токену API. Создайте свой токен API с помощью консоли управления кластером (CMC). Чтобы узнать, как его получить и использовать, см. Аутентификация кластера.
Конечная точка
/api/v1.0/onpremise/passwordPolicy
Параметры
| Параметр | Тип | Описание | В | Обязательно |
|---|---|---|---|---|
| body | PasswordPolicy | Тело JSON запроса. Содержит параметры конфигурации политики паролей. | body | Нет |
Объекты тела запроса
Объект PasswordPolicy
Конфигурация политики паролей.
| Элемент | Тип | Описание | Обязательно |
|---|---|---|---|
| minPasswordLength | integer | Минимальная длина пароля | Да |
| minNumberOfUppercaseChars | integer | Минимальное количество символов верхнего регистра | Да |
| minNumberOfLowercaseChars | integer | Минимальное количество символов нижнего регистра | Да |
| minNumberOfDigits | integer | Минимальное количество цифр | Да |
| minNumberOfNonAlphanumericChars | integer | Минимальное количество специальных символов | Да |
JSON-модель тела запроса
Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.
<{
"minPasswordLength": 1,
"minNumberOfUppercaseChars": 1,
"minNumberOfLowercaseChars": 1,
"minNumberOfDigits": 1,
"minNumberOfNonAlphanumericChars": 1
}
Ответ
Коды ответа
| Код | Тип | Описание |
|---|---|---|
| 204 | Успешно обновлено. Ответ не имеет тела. | |
| 400 | ErrorEnvelope | Не удалось. Ввод недействителен. |
| 404 | Кластер не найден |
Пример
В этом примере вы обновляете политику паролей для управляемого развертывания (myАппОптима.cluster.com). Вы определяете:
- Минимальную длина пароля
- Минимальное количество символов верхнего регистра
- Минимальное количество символов нижнего регистра
- Минимальное количество цифр
- Минимальное количество специальных символов
В ответ вы получите код ответа 204, указывающий, что политика паролей была успешно обновлена.
Curl
curl -X PUT "https://myАппОптима.cluster.com/api/v1.0/onpremise/passwordPolicy" -H "accept: */*" -H "Content-Type: application/json" -d "{\"realmId\":\"string\",\"minPasswordLength\":16,\"minNumberOfUppercaseChars\":2,\"minNumberOfLowercaseChars\":4,\"minNumberOfDigits\":2,\"minNumberOfNonAlphanumericChars\":4}"
URL-адрес запроса
https://myАппОптима.cluster.com/api/v1.0/onpremise/passwordPolicy
Тело ответа
Успешно обновлено. Ответ не имеет тела.
Код ответа
204