Метод PutConfigurationSetDeliveryOptions
Обновляет настройки доставки для конфигурации в каталоге. Нужный каталог определяется по сервисному аккаунту, от имени которого выполняется запрос.
Запрос
PUT /v2/email/configuration-sets/{ConfigurationSetName}/delivery-options HTTP/2
Path-параметры
|
Параметр |
Описание |
|
|
Тип: string. Название конфигурации, которая будет изменена. |
Заголовки запроса
Используйте в запросе общие заголовки.
Тело запроса
{
"TlsPolicy": "REQUIRE|OPTIONAL",
"SendingPoolName": "<имя_пула>"
}
|
Параметр |
Описание |
|
|
Тип: string. Политика безопасности исходящего соединения. Указывает, требуется ли использовать протокол TLS для писем, к которым применена конфигурация. Если значение — |
|
|
Тип: string. Имя пула, с IP-адресов которого будут отправляться письма с конфигурацией. Необязательный параметр. |
Важно
Метод полностью обновляет настройки доставки конфигурации. Если при вызове не указать SendingPoolName, пул отвяжется от конфигурации, и письма станут отправляться с общих IP-адресов сервиса.
Примечание
Если к конфигурации привязан пул, в котором нет ни одного выделенного IP-адреса, письма с этой конфигурацией не отправляются: метод SendEmail возвращает ошибку 404 NotFoundException. Автоматического переключения на общий пул IP-адресов сервиса не происходит.
Ответы
200 OK
Ответ 200 OK возвращается в случае успешного выполнения запроса.
Ошибки
Для всех ошибок тело ответа представлено в одинаковом формате:
{
"Code": "<название_ошибки>",
"message": "<пояснение_к_ошибке>"
}
Название ошибки заимствуется из ее кода, например BadRequestException.
Возможные ошибки:
|
Код ошибки |
Описание |
|
|
В запросе неправильно указаны заголовки или параметры, либо пула, указанного в |
|
|
Запрошенный ресурс не найден. |
|
|
При вызове запроса превышена квота. |