Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • Машинное обучение
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Истории успеха
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Cloud Postbox
  • Начало работы
  • Управление доступом
  • Правила тарификации
    • Аутентификация в API
    • Как пользоваться API
    • Подписывание запросов
      • Все методы
      • Отправка писем
        • Метод ListDomainIdentities
        • Метод GetDomainIdentity
        • Метод CreateDomainIdentity
        • Метод PutDomainIdentityDkimAttributes
        • Метод DeleteDomainIdentity
      • Заголовки запросов
  • Аудитные логи Audit Trails
  • История изменений

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

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

Метод GetDomainIdentity

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

Возвращает информацию об адресе в каталоге. Нужный каталог определяется по сервисному аккаунту, от имени которого выполняется запрос.

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

GET /v2/email/identities/{DomainIdentity} HTTP/2

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

Параметр

Описание

DomainIdentity

Тип: string.

Адрес, о котором запрашивается информация. Минимальная длина — один символ.

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

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

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

200 OK200 OK

{
  "IdentityType": "<тип_адреса>",
  "FeedbackForwardingStatus": <статус_уведомлений_о_неполадках>,
  "VerifiedForSendingStatus": <статус_верификации_для_отправки_писем>,
  "DkimAttributes": {
    "SigningEnabled": <использование_DKIM>,
    "Status": "<статус_поиска_DKIM>",
    "Tokens": [
      "<селектор_для_открытого_ключа>"
    ],
    "SigningAttributesOrigin": "<способ_конфигурации_DKIM>",
    "NextSigningKeyLength": "<параметр_для_совместимости>",
    "CurrentSigningKeyLength": "<параметр_для_совместимости>"
  },
  "Tags": [
    {
      "Key": "<ключ_метки>",
      "Value": "<значение_метки>"
    }
  ],
  "ConfigurationSetName": "<название_конфигурации>",
  "VerificationStatus": "<статус_верификации_адреса>"
}

Параметр

Описание

IdentityType

Тип: string.

Тип адреса. Значение — DOMAIN.

FeedbackForwardingStatus

Тип: boolean.

Возможные значения: true или false. Если указано значение true, вы будете получать уведомления в случае неполадок с доставкой и отправкой писем.

VerifiedForSendingStatus

Тип: boolean.

Указывает, можно ли отправлять электронную почту с этого адреса. Возможные значения: true или false.
Чтобы отправлять почту, адрес необходимо верифицировать.

DkimAttributes

Тип: object.

Объект, который содержит параметры DKIM-подписи.

SigningEnabled

Тип: boolean.

Указывает, используется ли DKIM-подпись при отправке электронной почты с этого адреса. Возможные значения: true или false.

Status

Тип: string.

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

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

Tokens

Тип: array.

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

SigningAttributesOrigin

Тип: string.

Указывает, как была настроена DKIM-подпись. Значение EXTERNAL говорит о том, что DKIM-подпись настроена с помощью BYODKIM.

NextSigningKeyLength

Тип: string.

Используется только для совместимости с AWS.

CurrentSigningKeyLength

Тип: string.

Используется только для совместимости с AWS.

Tags

Тип: array.

Массив меток для адреса.

ConfigurationSetName

Тип: string.

Название конфигурации.

VerificationStatus

Тип: string.

Статус верификации:

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

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

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

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

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

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

Код ошибки

Описание

400 BadRequestException

В запросе неправильно указаны заголовки или параметры.

404 NotFoundException

Запрошенный ресурс не найден.

429 TooManyRequestsException

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

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

Предыдущая
Метод ListDomainIdentities
Следующая
Метод CreateDomainIdentity
Проект Яндекса
© 2025 ООО «Яндекс.Облако»