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

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

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

Метод UpdateConfigurationSetEventDestination

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

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

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

PUT /v2/email/configuration-sets/{ConfigurationSetName}/event-destinations/{EventDestinationName} HTTP/2

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

Параметр

Описание

ConfigurationSetName

Тип: string.

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

EventDestinationName

Тип: string.

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

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

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

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

{
  "EventDestination": {
    "Enabled": <состояние_подписки>,
    "KinesisFirehoseDestination": {
      "IamRoleArn": "<параметр_для_совместимости>",
      "DeliveryStreamArn": "<поток данных>"
    }
  }
}

Параметр

Описание

EventDestination

Тип: объект.

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

Enabled

Тип: boolean.

Состояние подписки: true — включена, false — выключена. Если подписка включена, в указанный поток отправляются уведомления о доставке писем.

KinesisFirehoseDestination

Тип: object.

Объект, который определяет место назначения для отправки уведомлений.

IamRoleArn

Тип: string.

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

DeliveryStreamArn

Тип: string.

Поток данных Yandex Data Streams, в который отправляются уведомления.

Формат: arn:yc:yds:<регион>::<эндпоинт>:<название потока>. Эндпоинт можно скопировать из поля Kinesis API эндпоинт нужного потока в Data Streams.

Пример

arn:yc:yds:ru-central1::https://yds.serverless.yandexcloud.net/ru-central1/b1gkgm9daf9605nj****/etn5nuveugdr18ak****:postbox

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

200 OK200 OK

Ответ 200 OK возвращается в случае успешного выполнения запроса.

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

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

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

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

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

Код ошибки

Описание

400 BadRequestException

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

404 NotFoundException

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

429 TooManyRequestsException

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

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

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