Метод CreateDomainIdentity
Создает адрес в каталоге. Нужный каталог определяется по сервисному аккаунту, от имени которого выполняется запрос.
При создании адреса можно настроить DKIM-подпись одним из двух способов:
- Простая настройка (Easy DKIM) — Yandex Cloud Postbox самостоятельно генерирует и хранит ключи DKIM. Используется по умолчанию, если объект
DkimSigningAttributesне передан или в нем указано только полеNextSigningKeyLength. В ответе сервис возвращает селекторы (Tokens), на основе которых нужно добавить CNAME-записи в DNS пользовательского домена. - Расширенная настройка (BYODKIM) — пользователь указывает собственный ключ. Применяется, только если в объекте
DkimSigningAttributesпереданы оба поля:DomainSigningSelectorиDomainSigningPrivateKey.
Запрос
POST /v2/email/identities HTTP/2
Заголовки запроса
Используйте в запросе общие заголовки.
Тело запроса
{
"EmailIdentity": "<адрес>",
"Tags": [
{
"Key": "<ключ_метки>",
"Value": "<значение_метки>"
}
],
"DkimSigningAttributes": {
"NextSigningKeyLength": "<длина_ключа>",
"DomainSigningSelector": "<название_селектора>",
"DomainSigningPrivateKey": "<закрытый_ключ>"
},
"ConfigurationSetName": "<название_конфигурации>"
}
|
Параметр |
Описание |
|
|
Тип: string. Адрес. |
|
|
Тип: array. Массив меток для адреса. Максимальное количество — 50 меток. |
|
|
Тип: string. Ключ метки. Минимальная длина ключевого слова — 1 символ, максимальная — 63 символа. |
|
|
Тип: string. Значение метки. Минимальная длина значения метки — 0 символов (значение отсутствует), максимальная — 256 символов. |
|
|
Тип: object. Необязательный объект с параметрами DKIM-подписи. Способ настройки DKIM определяется содержимым объекта:
Если объект не передан, используется простая настройка DKIM с ключом RSA длиной 2048 бит. Запрос завершится ошибкой, если передать только одно из полей |
|
|
Тип: string. Необязательное поле. Длина ключа RSA, который Yandex Cloud Postbox сгенерирует при простой настройке DKIM-подписи (Easy DKIM). Возможные значения:
Поле нельзя передавать вместе с полями |
|
|
Тип: string. Название селектора, который используется для идентификации открытого ключа в конфигурации DNS для домена. Минимальная длина названия селектора —— 1 символ, максимальная — 63 символа. |
|
|
Тип: string. Закрытый ключ, который используется для генерации DKIM-подписи. Закрытый ключ должен использовать 1024- или 2048-битное шифрование RSA и должен быть закодирован с использованием кодировки base64. Минимальная длина ключа —— 1 символ, максимальная — 20480 символов. |
|
|
Тип: string. Название конфигурации, которую вы хотите привязать к адресу. Конфигурация должна находиться в том же каталоге, что и адрес. |
Ответы
200 OK
{
"IdentityType": "<тип_адреса>",
"VerifiedForSendingStatus": <статус_верификации_для_отправки_писем>,
"DkimAttributes": {
"SigningEnabled": <использование_DKIM>,
"Status": "<статус_поиска_DKIM>",
"Tokens": [
"<селектор_для_открытого_ключа>"
],
"SigningAttributesOrigin": "<способ_конфигурации_DKIM>",
"NextSigningKeyLength": "<длина_следующего_ключа>",
"CurrentSigningKeyLength": "<длина_текущего_ключа>"
}
}
|
Параметр |
Описание |
|
|
Тип: string. Тип адреса. Возможное значение — |
|
|
Тип: boolean. Указывает, подтверждено ли владение адресом. Возможные значения: Вы можете отправлять электронные письма только с проверенных адресов. |
|
|
Тип: object. Объект, который содержит параметры DKIM-подписи. |
|
|
Тип: boolean. Указывает, используется ли DKIM-подпись при отправке электронной почты с этого адреса. Возможные значения: |
|
|
Тип: string. Указывает, удалось ли Yandex Cloud Postbox обнаружить DKIM-подпись в DNS-конфигурации адреса. Возможные значения:
|
|
|
Тип: array. Список селекторов для идентификации открытого ключа. При простой настройке DKIM (Easy DKIM) возвращаются два селектора: для каждого из них необходимо добавить CNAME-запись в DNS пользовательского домена, чтобы подтвердить владение доменом. Тип для селектора: string. |
|
|
Тип: string. Указывает, как была настроена DKIM-подпись. Возможные значения:
|
|
|
Тип: string. Длина ключа RSA, который будет использован при следующей ротации ключа DKIM при простой настройке (Easy DKIM). Возможные значения: |
|
|
Тип: string. Длина текущего ключа RSA, который используется для DKIM-подписи при простой настройке (Easy DKIM). Возможные значения: |
Ответ 200 OK может содержать дополнительные параметры. Он не возвращается строго в формате, указанном выше.
Ошибки
Для всех ошибок тело ответа представлено в одинаковом формате:
{
"Code": "<название_ошибки>",
"message": "<пояснение_к_ошибке>"
}
Название ошибки заимствуется из ее кода, например BadRequestException.
Возможные ошибки:
|
Код ошибки |
Описание |
|
|
В запросе переданы неправильные заголовки или параметры. |
|
|
Не найден запрашиваемый ресурс. |
|
|
Конфигурация с таким названием уже существует, выберите другие имя. |
|
|
Конфликт операций. Дождитесь завершения предыдущей операции и повторите запрос. |
|
|
При вызове запроса превышена квота. |
|
|
При вызове запроса превышен лимит. |