Статус хранилища SSL-сертификата кластера

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

Установка и настройка / Основные элементы Ключ-Астром / Ключ-АСТРОМ Managed / REST API / API Кластера v1 / SSL-сертификаты / Статус хранилища SSL-сертификата кластера

Этот вызов API извлекает состояние хранилища SSL-сертификата кластера.

BAD_REQUEST

Состояние хранилища сертификата доступно только во время обновления или загрузки сертификата. После загрузки сертификата и перезапуска узла этот вызов API вернет BAD_REQUEST, поскольку состояние хранилища недоступно.

Аутентификация

Для выполнения этого запроса вам необходимо разрешение API (ServiceProviderAPI), назначенное вашему токену API. Создайте свой токен API с помощью консоли управления кластером (CMC). Чтобы узнать, как его получить и использовать, см. Аутентификация кластера.

Конечная точка

/api/v1.0/onpremise/sslCertificate/store

Параметры

Параметр Тип Описание В Обязательно
entityType string тип объекта (COLLECTOR, SERVER) path Да
entityId integer Идентификатор узла, который можно извлечь из URL-адреса в представлении «Сведения об узле». path Да

Ответ

Коды ответа

Код Тип Описание
200 CertificateStoreStatus Успешно или в процессе
400 CertificateStoreStatus Неверный тип объекта
404 CertificateStoreStatus Статус не найден
500 Внутренняя ошибка
522 CertificateStoreStatus Цепочка сертификатов недействительна.
523 CertificateStoreStatus Закрытый ключ не соответствует сертификату открытого ключа
525 CertificateStoreStatus Сертификат открытого ключа недействителен
526 CertificateStoreStatus Закрытый ключ недействителен
527 CertificateStoreStatus Ошибка при сохранении SSL-сертификата
528 CertificateStoreStatus Сертификат сохранен, но не обновлен
529 CertificateStoreStatus Внутренняя ошибка

Объекты тела ответа

Объект CertificateStoreStatus

Элемент Тип Описание
certificateStoreStatus string Может иметь значения:
  • BAD_REQUEST
  • CERTIFICATE_CHAIN_IS_INVALID
  • CERTIFICATE_IS_EXPIRED
  • CERTIFICATE_STORED_BUT_NOT_REFRESHED
  • ERROR
  • GENERAL_ERROR_WHILE_STORING_CERTIFICATE
  • IN_PROGRESS
  • NOT_FOUND
  • OK
  • PRIVATE_KEY_DOES_NOT_MATCH_PUBLIC_KEY_CERTIFICATE
  • PRIVATE_KEY_IS_INVALID
  • PUBLIC_KEY_CERTIFICATE_IS_INVALID
detailedError string -

JSON-модель тела ответа

{
  "certificateStoreStatus": "BAD_REQUEST",
  "detailedError": "string"
}

Пример

В этом примере вы проверяете состояние хранилища сертификатов SSL на узле №32 кластера myManaged.cluster.com. В ответ вы получаете информацию о состоянии хранения SSL-сертификата, указывающую, что SSL-сертификат был успешно сохранен.

Curl

curl -X GET "https://myManaged.cluster.com/api/v1.0/onpremise/sslCertificate/store/SERVER/32" -H  "accept: application/json" -H  "Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890"

URL-адрес запроса

https://myManaged.cluster.com/api/v1.0/onpremise/sslCertificate/store/SERVER/32

Тело ответа

{
  "certificateStoreStatus": "Successful",
  "detailedError": null
}

Код ответа

200