Yandex Cloud
Документация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»
Yandex Cloud Postbox
RU
  • Начало работы
  • Управление доступом
  • Правила тарификации
    • Аутентификация в API
    • Как пользоваться API
    • Подписывание запросов
      • Все методы
      • Отправка писем
      • Массовая отправка писем
        • Метод ListDomainIdentities
        • Метод GetDomainIdentity
        • Метод CreateDomainIdentity
        • Метод PutDomainIdentityDkimAttributes
        • Метод PutEmailIdentityDkimSigningAttributes
        • Метод DeleteDomainIdentity
      • Заголовки запросов
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Публичные материалы
  • История изменений
  • Вопросы и ответы

В этой статье:

  • Запрос
  • Path-параметры
  • Заголовки запроса
  • Тело запроса
  • Ответы
  • 200 OK
  • Ошибки
  1. Справочник API
  2. REST
  3. Адреса
  4. Метод PutEmailIdentityDkimSigningAttributes

Метод PutEmailIdentityDkimSigningAttributes

Статья создана
Yandex Cloud
Обновлена 16 ноября 2026 г.
Открыть в Markdown
  • Запрос
    • Path-параметры
    • Заголовки запроса
    • Тело запроса
  • Ответы
    • 200 OK
    • Ошибки

Перепроверяет DKIM-подпись адреса в каталоге и возвращает ее статус. Нужный каталог определяется по сервисному аккаунту, от имени которого выполняется запрос.

Важно

В Yandex Cloud Postbox метод работает не так, как в Amazon SES: он не изменяет настройки DKIM-подписи, а только синхронно проверяет DNS-записи DKIM. Изменить способ настройки DKIM-подписи или ее параметры с помощью метода нельзя.

ЗапросЗапрос

PUT /v2/email/identities/{EmailIdentity}/dkim/signing HTTP/2

Path-параметрыPath-параметры

Параметр

Описание

EmailIdentity

Тип: string.

Адрес, DKIM-подпись которого нужно перепроверить.

Заголовки запросаЗаголовки запроса

Используйте в запросе общие заголовки.

Тело запросаТело запроса

{
  "SigningAttributesOrigin": "AWS_SES|EXTERNAL"
}

Параметр

Описание

SigningAttributesOrigin

Тип: string.

Способ настройки DKIM-подписи адреса. Возможные значения:

  • AWS_SES — простая настройка (Easy DKIM).
  • EXTERNAL — расширенная настройка (BYODKIM).

Значение должно совпадать с текущим способом настройки DKIM-подписи адреса. Его можно узнать в поле SigningAttributesOrigin ответа метода GetDomainIdentity.

Обязательный параметр.

Параметр SigningAttributes не поддерживается. Если передать его в запросе, метод вернет ошибку 400 BadRequestException.

ОтветыОтветы

200 OK200 OK

{
  "DkimStatus": "<статус_DKIM>",
  "DkimTokens": [
    "<селектор_для_открытого_ключа>"
  ]
}

Параметр

Описание

DkimStatus

Тип: string.

Результат проверки DKIM-подписи в DNS-конфигурации адреса. Возможные значения:

  • PENDING — поиск запущен, но сервис пока не обнаружил DKIM-подпись в DNS-конфигурации адреса.
  • SUCCESS — DKIM-подпись обнаружена.
  • FAILED — не удалось обнаружить DKIM-подпись.
  • TEMPORARY_FAILURE — из-за временной проблемы Yandex Cloud Postbox не может обнаружить DKIM-подпись.
  • NOT_STARTED — поиск не был запущен.

DkimTokens

Тип: array.

Список селекторов для идентификации открытого ключа. Тип для селектора: string.

ОшибкиОшибки

Для всех ошибок тело ответа представлено в одинаковом формате:

{
   "Code": "<название_ошибки>",
   "message": "<пояснение_к_ошибке>"
}

Название ошибки заимствуется из ее кода, например BadRequestException.

Возможные ошибки:

Код ошибки

Описание

400 BadRequestException

В запросе неправильно указаны заголовки или параметры. Также возвращается, если передан параметр SigningAttributes или значение SigningAttributesOrigin не совпадает с текущим способом настройки DKIM-подписи адреса.

404 NotFoundException

Адрес не найден.

429 TooManyRequestsException

При вызове запроса превышена квота.

Была ли статья полезна?

Предыдущая
Метод PutDomainIdentityDkimAttributes
Следующая
Метод DeleteDomainIdentity
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»