Метод GetDomainIdentity
Возвращает информацию об адресе в каталоге. Нужный каталог определяется по сервисному аккаунту, от имени которого выполняется запрос.
Запрос
GET /v2/email/identities/{DomainIdentity} HTTP/2
Path-параметры
Параметр |
Описание |
|
Тип: string. Адрес, о котором запрашивается информация. Минимальная длина — один символ. |
Заголовки запроса
Используйте в запросе общие заголовки.
Ответы
200 OK
{
"IdentityType": "<тип_адреса>",
"FeedbackForwardingStatus": <статус_уведомлений_о_неполадках>,
"VerifiedForSendingStatus": <статус_верификации_для_отправки_писем>,
"DkimAttributes": {
"SigningEnabled": <использование_DKIM>,
"Status": "<статус_поиска_DKIM>",
"Tokens": [
"<селектор_для_открытого_ключа>"
],
"SigningAttributesOrigin": "<способ_конфигурации_DKIM>",
"NextSigningKeyLength": "<параметр_для_совместимости>",
"CurrentSigningKeyLength": "<параметр_для_совместимости>"
},
"Tags": [
{
"Key": "<ключ_метки>",
"Value": "<значение_метки>"
}
],
"ConfigurationSetName": "<название_конфигурации>",
"VerificationStatus": "<статус_верификации_адреса>"
}
Параметр |
Описание |
|
Тип: string. Тип адреса. Значение — |
|
Тип: boolean. Возможные значения: |
|
Тип: boolean. Указывает, можно ли отправлять электронную почту с этого адреса. Возможные значения: |
|
Тип: object. Объект, который содержит параметры DKIM-подписи. |
|
Тип: boolean. Указывает, используется ли DKIM-подпись при отправке электронной почты с этого адреса. Возможные значения: |
|
Тип: string. Указывает, удалось ли Yandex Cloud Postbox обнаружить DKIM-подпись в DNS-конфигурации адреса. Возможные значения:
|
|
Тип: array. Список селекторов для идентификации открытого ключа. Тип для селектора: string. |
|
Тип: string. Указывает, как была настроена DKIM-подпись. Значение |
|
Тип: string. Используется только для совместимости с AWS. |
|
Тип: string. Используется только для совместимости с AWS. |
|
Тип: array. Массив меток для адреса. |
|
Тип: string. Название конфигурации. |
|
Тип: string. Статус верификации:
|
Ошибки
Для всех ошибок тело ответа представлено в одинаковом формате:
{
"Code": "<название_ошибки>",
"message": "<пояснение_к_ошибке>"
}
Название ошибки заимствуется из ее кода, например BadRequestException
.
Возможные ошибки:
Код ошибки |
Описание |
|
В запросе неправильно указаны заголовки или параметры. |
|
Запрошенный ресурс не найден. |
|
При вызове запроса превышена квота. |