Метод get
Возвращает информацию об указанном сертификате.
Чтобы получить список доступных сертификатов, используйте запрос list.
HTTP-запрос
GET https://certificate-manager.api.cloud.yandex.net/certificate-manager/v1/certificates/{certificateId}
Path-параметры
Параметр | Описание |
---|---|
certificateId | Обязательное поле. Идентификатор возвращаемого сертификата. Чтобы получить идентификатор сертификата, используйте запрос list. Максимальная длина строки в символах — 50. |
Query-параметры
Параметр | Описание |
---|---|
view | Тип вывода сертификата.
|
Ответ
HTTP Code: 200 - OK
{
"id": "string",
"folderId": "string",
"createdAt": "string",
"name": "string",
"description": "string",
"labels": "object",
"type": "string",
"domains": [
"string"
],
"status": "string",
"issuer": "string",
"subject": "string",
"serial": "string",
"updatedAt": "string",
"issuedAt": "string",
"notAfter": "string",
"notBefore": "string",
"challenges": [
{
"domain": "string",
"type": "string",
"createdAt": "string",
"updatedAt": "string",
"status": "string",
"message": "string",
"error": "string",
// `challenges[]` включает только одно из полей `dnsChallenge`, `httpChallenge`
"dnsChallenge": {
"name": "string",
"type": "string",
"value": "string"
},
"httpChallenge": {
"url": "string",
"content": "string"
},
// конец списка возможных полей`challenges[]`
}
]
}
Сертификат. Подробнее об этом читайте в документации.
Поле | Описание |
---|---|
id | string Идентификатор сертификата. Генерируется при создании. |
folderId | string Идентификатор каталога, которому принадлежит сертификат. |
createdAt | string (date-time) Время создания ресурса. Строка в формате RFC3339. |
name | string Имя сертификата. Имя должно быть уникальным в каталоге. |
description | string Описание сертификата. |
labels | object Метки ресурса в формате |
type | string Тип сертификата. Поддерживаемые типы сертификатов.
|
domains[] | string Полные доменные имена сертификата. |
status | string Статус сертификата.
|
issuer | string Уникальное имя Distinguished Name центра сертификации, выпустившего сертификат. |
subject | string Уникальное имя Distinguished Name сущности, связанной с открытым ключом, содержащимся в сертификате. |
serial | string Серийный номер сертификата. |
updatedAt | string (date-time) Время последнего изменения сертификата. Строка в формате RFC3339. |
issuedAt | string (date-time) Время выдачи сертификата. Строка в формате RFC3339. |
notAfter | string (date-time) Время, по истечении которого сертификат считается недействительным. Строка в формате RFC3339. |
notBefore | string (date-time) Время, после наступления которого сертификат считается действительным. Строка в формате RFC3339. |
challenges[] | object Процедура проверки домена. |
challenges[]. domain |
string Домен, права на владение которым проверяются. |
challenges[]. type |
string Тип процедуры проверки. Поддерживаемые типы проверки домена.
|
challenges[]. createdAt |
string (date-time) Время, когда была начата процедура проверки. Строка в формате RFC3339. |
challenges[]. updatedAt |
string (date-time) Время последней проверки. Строка в формате RFC3339. |
challenges[]. status |
string Статус процедуры проверки.
|
challenges[]. message |
string Описание процедуры проверки. |
challenges[]. error |
string Ошибка процедуры проверки. |
challenges[]. dnsChallenge |
object DNS-запись. challenges[] включает только одно из полей dnsChallenge , httpChallenge |
challenges[]. dnsChallenge. name |
string Имя DNS-записи. |
challenges[]. dnsChallenge. type |
string Тип DNS-записи. |
challenges[]. dnsChallenge. value |
string Значение DNS-записи. |
challenges[]. httpChallenge |
object HTTP-файл. challenges[] включает только одно из полей dnsChallenge , httpChallenge |
challenges[]. httpChallenge. url |
string Расположение HTTP-файла. |
challenges[]. httpChallenge. content |
string Содержимое HTTP-файла. |