Метод PutDedicatedIpInPool
Перемещает выделенный IP-адрес в указанный пул. Нужный каталог определяется по сервисному аккаунту, от имени которого выполняется запрос.
Один IP-адрес в каждый момент времени может находиться только в одном пуле. Чтобы удалить IP-адрес из пользовательского пула, переместите его в пул по умолчанию ses-default-dedicated-pool.
Операция идемпотентна: повторное перемещение IP-адреса в тот же пул завершается успешно.
Запрос
PUT /v2/email/dedicated-ips/{IP}/pool HTTP/2
Path-параметры
|
Параметр |
Описание |
|
|
Тип: string. Выделенный IP-адрес, который будет перемещен. |
Заголовки запроса
Используйте в запросе общие заголовки.
Тело запроса
{
"DestinationPoolName": "<имя_пула_назначения>"
}
|
Параметр |
Описание |
|
|
Тип: string. Имя пула, в который будет перемещен IP-адрес. |
Ответы
200 OK
Ответ 200 OK возвращается в случае успешного выполнения запроса.
Ошибки
Для всех ошибок тело ответа представлено в одинаковом формате:
{
"Code": "<название_ошибки>",
"message": "<пояснение_к_ошибке>"
}
Название ошибки заимствуется из ее кода, например BadRequestException.
Возможные ошибки:
|
Код ошибки |
Описание |
|
|
В запросе неправильно указаны заголовки или параметры. |
|
|
IP-адрес не найден или не принадлежит вашему облаку, либо пул назначения не существует. |
|
|
При вызове запроса превышена квота. |
Существование IP-адреса проверяется раньше существования пула. Если неправильно указаны оба параметра, вернется ошибка об IP-адресе.