Управление пользовательским стоп-листом
В пользовательском стоп-листе находятся адреса получателей, которым Yandex Cloud Postbox не отправляет письма, если причина, по которой адрес добавлен в список, блокирует отправку. Список создается для облака и является общим для всех каталогов, адресов и конфигураций внутри него.
Чтобы просматривать стоп-лист, необходима роль postbox.viewer. Чтобы добавлять и удалять адреса — роль postbox.editor.
Чтобы Yandex Cloud Postbox проверял пользовательский стоп-лист при отправке писем, задайте настройки стоп-листа в конфигурации.
Добавить адрес получателя в стоп-лист
- Перейдите в сервис Cloud Postbox.
- На панели слева выберите Стоп-лист.
- Нажмите Добавить.
- В поле Адрес электронной почты укажите адрес получателя, который необходимо добавить в пользовательский стоп-лист.
- В поле Причина выберите причину, по которой адрес получателя необходимо добавить в пользовательский стоп-лист.
- Нажмите Сохранить.
Если у вас еще нет интерфейса командной строки AWS CLI, установите и сконфигурируйте его.
Добавьте адрес получателя в стоп-лист:
aws sesv2 put-suppressed-destination \
--endpoint-url=https://postbox.cloud.yandex.net \
--profile <имя_профиля> \
--email-address <адрес_получателя> \
--reason <причина добавления>
Где:
--email-address— адрес получателя, который необходимо добавить в пользовательский стоп-лист;--reason— причина, по которой адрес получателя необходимо добавить в пользовательский стоп-лист.
Чтобы добавить адрес получателя в пользовательский стоп-лист, воспользуйтесь методом PutSuppressedDestination.
Если адрес уже есть в стоп-листе, новая запись не создается: у текущей записи обновляются причина и время изменения.
Посмотреть стоп-лист
- Перейдите в сервис Cloud Postbox.
- На панели слева выберите Стоп-лист.
Для каждого адреса в пользовательском стоп-листе отображаются причина, дата добавления и, если адрес добавлен в стоп-лист автоматически, Message-ID письма, из-за которого это произошло.
Получите список адресов в стоп-листе:
aws sesv2 list-suppressed-destinations \
--endpoint-url=https://postbox.cloud.yandex.net \
--profile <имя_профиля> \
--reasons COMPLAINT \
--page-size 50
Параметры --reasons, --start-date и --end-date необязательные. Без них возвращаются адреса со всеми причинами за все время.
Чтобы посмотреть пользовательский стоп-лист, воспользуйтесь методом ListSuppressedDestinations.
Адреса возвращаются отсортированными от недавно измененных к более старым. Найти в списке конкретный адрес с помощью фильтра нельзя: чтобы проверить, есть ли адрес в стоп-листе, посмотрите информацию об адресе.
Посмотреть информацию об адресе получателя в стоп-листе
Получите информацию об адресе:
aws sesv2 get-suppressed-destination \
--endpoint-url=https://postbox.cloud.yandex.net \
--profile <имя_профиля> \
--email-address <адрес_получателя>
Чтобы посмотреть информацию об адресе получателя в пользовательском стоп-листе, воспользуйтесь методом GetSuppressedDestination.
Если адрес получателя попал в стоп-лист автоматически, в ответе будет Message-ID письма, из-за которого это произошло.
Удалить адрес получателя из стоп-листа
- Перейдите в сервис Cloud Postbox.
- На панели слева выберите Стоп-лист.
- В строке с нужным адресом нажмите .
- Подтвердите удаление.
Удалите адрес из стоп-листа:
aws sesv2 delete-suppressed-destination \
--endpoint-url=https://postbox.cloud.yandex.net \
--profile <имя_профиля> \
--email-address <адрес_получателя>
Чтобы удалить адрес получателя из пользовательского стоп-листа, воспользуйтесь методом DeleteSuppressedDestination.
Важно
Если адрес находится в глобальном стоп-листе, он не разблокируется после удаления из пользовательского стоп-листа.