Управление выделенными IP-адресами

Если у вас еще нет интерфейса командной строки AWS CLI, установите и сконфигурируйте его.

Чтобы управлять выделенными IP-адресами, назначьте сервисному аккаунту, через который работает AWS CLI, роль postbox.editor.

1. В терминале определите переменные:

   ENDPOINT=https://postbox.cloud.yandex.net
   PROFILE=<имя_профиля>
   POOL_NAME=<имя_пула>
   CONFIGSET_NAME=<имя_конфигурации>
   IP=<выделенный_IP-адрес>
   

2. Посмотрите список выделенных IP-адресов, которые выданы вашему облаку:

   aws sesv2 get-dedicated-ips \
      --endpoint-url=$ENDPOINT \
      --profile $PROFILE
   

   IP-адреса, которые не распределены по пользовательским пулам, находятся в пуле по умолчанию ses-default-dedicated-pool.

3. Создайте пул:

   aws sesv2 create-dedicated-ip-pool \
      --endpoint-url=$ENDPOINT \
      --profile $PROFILE \
      --pool-name $POOL_NAME
   

   Имя пула должно быть уникальным в рамках облака и может содержать строчные латинские буквы, цифры, символы подчеркивания _ и дефисы -. Длина имени — от 1 до 64 символов. Нельзя указывать имена, зарезервированные сервисом.

4. Добавьте выделенный IP-адрес в пул:

   aws sesv2 put-dedicated-ip-in-pool \
      --endpoint-url=$ENDPOINT \
      --profile $PROFILE \
      --ip $IP \
      --destination-pool-name $POOL_NAME
   

   Один IP-адрес в каждый момент времени может находиться только в одном пуле.

5. Привяжите пул к конфигурации:

   aws sesv2 put-configuration-set-delivery-options \
      --endpoint-url=$ENDPOINT \
      --profile $PROFILE \
      --configuration-set-name $CONFIGSET_NAME \
      --sending-pool-name $POOL_NAME \
      --tls-policy REQUIRE
   

   Важно

   Команда полностью обновляет настройки доставки конфигурации. Если выполнить ее, не указав --sending-pool-name, пул отвяжется от конфигурации, и письма станут отправляться с общих IP-адресов сервиса.

   Если к конфигурации привязан пул, в котором нет ни одного выделенного IP-адреса, письма с этой конфигурацией не отправляются: метод SendEmail возвращает ошибку 404 NotFoundException. Автоматического переключения на общий пул IP-адресов сервиса не происходит.

6. Проверьте состав пула:

   aws sesv2 get-dedicated-ips \
      --endpoint-url=$ENDPOINT \
      --profile $PROFILE \
      --pool-name $POOL_NAME
   

7. Чтобы убрать IP-адрес из пользовательского пула, переместите его в пул по умолчанию:

   aws sesv2 put-dedicated-ip-in-pool \
      --endpoint-url=$ENDPOINT \
      --profile $PROFILE \
      --ip $IP \
      --destination-pool-name ses-default-dedicated-pool
   

8. Удалите пул:

   aws sesv2 delete-dedicated-ip-pool \
      --endpoint-url=$ENDPOINT \
      --profile $PROFILE \
      --pool-name $POOL_NAME
   

   Примечание

   Пул, привязанный к конфигурации, нельзя удалить. Сначала отвяжите пул от всех конфигураций, к которым он привязан.

   Пул можно удалить, даже если в нем есть выделенные IP-адреса: при удалении пула все IP-адреса автоматически перемещаются в пул по умолчанию ses-default-dedicated-pool.