создание отчета о тестировании доставки
Описание
Создайте новый прогнозируемый тест размещения в папке «Входящие». Прогнозируемые тесты размещения в папке «Входящие» могут помочь вам спрогнозировать, как различные поставщики электронной почты по всему миру обработают ваши сообщения. При выполнении прогнозируемого теста размещения в папке «Входящие» вы предоставляете образец сообщения, содержащий содержимое, которое вы планируете отправлять своим клиентам. Amazon SES затем отправляет это сообщение на специальные электронные адреса, распределенные по нескольким основным поставщикам электронной почты. По истечении примерно 24 часов тест завершается, и вы можете использовать операцию GetDeliverabilityTestReport, чтобы просмотреть результаты теста.
См. также: Документацию API AWS
Синтаксис
create-deliverability-test-report
[--report-name <value>]
--from-email-address <value>
--content <value>
[--tags <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--report-name (строка)
--from-email-address (строка)
--content (структура)
HTML-тело сообщения, которое вы отправили при выполнении теста прогнозируемого расположения входящих сообщений.
Простой -> (структура)
Простое электронное сообщение. Сообщение состоит из темы, тела сообщения и списка вложений.
Тема -> (структура)
Заголовок темы электронного письма. Заголовок темы может содержать только символы 7-битной ASCII. Однако вы можете указать символы, не являющиеся ASCII, в заголовке темы, используя синтаксис закодированных слов, как описано в RFC 2047.
Данные -> (строка)
Кодировка -> (строка)
UTF-8 , ISO-8859-1 или Shift_JIS.Тело -> (структура)
Тело сообщения. Вы можете указать HTML-версию сообщения, текстовую версию сообщения или обе.
Текст -> (структура)
Объект, представляющий версию сообщения, которая отображается в почтовых клиентах, не поддерживающих HTML, или клиентах, где получатель отключил отображение HTML.
Данные -> (строка)
Кодировка -> (строка)
UTF-8 , ISO-8859-1 или Shift_JIS.Html -> (структура)
Объект, представляющий версию сообщения, которая отображается в почтовых клиентах, поддерживающих HTML. HTML-сообщения могут включать форматированный текст, гиперссылки, изображения и многое другое.
Данные -> (строка)
Кодировка -> (строка)
UTF-8 , ISO-8859-1 или Shift_JIS.Заголовки -> (список)
Список заголовков сообщения, которые будут добавлены к электронному письму.
(структура)
Содержит имя и значение заголовка сообщения, который вы добавляете к электронному письму.
Имя -> (строка)
Имя заголовка сообщения. Имя заголовка сообщения должно соответствовать следующим критериям:
- Может содержать любые печатные символы ASCII (33 - 126) за исключением двоеточия (:).
- Может содержать не более 126 символов.
Значение -> (строка)
Значение заголовка сообщения. Значение заголовка сообщения должно соответствовать следующим критериям:
- Может содержать любые печатные символы ASCII.
- Может содержать не более 870 символов.
Вложения -> (список)
Список вложений, которые нужно включить в ваше электронное письмо. Все получатели получат те же вложения.
(структура)
Содержит метаданные и исходное содержимое вложения.
RawContent -> (бинарный)
ContentDisposition -> (строка)
ATTACHMENT или INLINE.Имя файла -> (строка)
Описание содержимого -> (строка)
ID содержимого -> (строка)
Кодировка передачи содержимого -> (строка)
BASE64 , QUOTED_PRINTABLE , SEVEN_BIT.Тип содержимого -> (строка)
Тип MIME вложения.
Примечание
Пример:application/pdf , image/jpeg
Необработанный -> (структура)
Необработанное электронное сообщение. Сообщение должно соответствовать следующим критериям:
- Сообщение должно содержать заголовок и тело, разделенные одной пустой строкой.
- Все необходимые поля заголовка должны присутствовать в сообщении.
- Каждая часть сообщения MIME multipart должна быть отформатирована правильно.
- Если вы включаете вложения, они должны быть в формате файла, который поддерживает API Amazon SES v2.
- Исходные данные сообщения должны быть закодированы в base64, если вы обращаетесь к Amazon SES напрямую через интерфейс HTTPS. Если вы обращаетесь к Amazon SES с помощью Amazon Web Services SDK, SDK позаботится о кодировании в base64 за вас.
- Если какие-либо части MIME в вашем сообщении содержат содержимое, выходящее за пределы диапазона символов 7-битной ASCII, вы должны закодировать это содержимое, чтобы почтовые клиенты получателей корректно отображали сообщение.
- Длина любой отдельной строки текста в сообщении не может превышать 1000 символов. Это ограничение определено в RFC 5321.
Данные -> (бинарный)
Необработанное электронное сообщение. Сообщение должно соответствовать следующим критериям:
- Сообщение должно содержать заголовок и тело, разделенные одной пустой строкой.
- Все необходимые поля заголовка должны присутствовать в сообщении.
- Каждая часть сообщения MIME multipart должна быть отформатирована правильно.
- Вложения должны быть в формате файла, который поддерживает Amazon SES.
- Исходные данные сообщения должны быть закодированы в base64, если вы обращаетесь к Amazon SES напрямую через интерфейс HTTPS. Если вы обращаетесь к Amazon SES с помощью Amazon Web Services SDK, SDK позаботится о кодировании в base64 за вас.
- Если какие-либо части MIME в вашем сообщении содержат содержимое, выходящее за пределы диапазона символов 7-битной ASCII, вы должны закодировать это содержимое, чтобы почтовые клиенты получателей корректно отображали сообщение.
- Длина любой отдельной строки текста в сообщении не может превышать 1000 символов. Это ограничение определено в RFC 5321.
Шаблон -> (структура)
Шаблон, который нужно использовать для электронного письма.
Имя шаблона -> (строка)
SendTemplatedEmail или SendBulkTemplatedEmail.TemplateArn -> (строка)
Содержимое шаблона -> (структура)
Содержимое шаблона.
Примечание
Amazon SES поддерживает только простые подстановки, когда вы отправляете электронные письма с помощью операцийSendEmail или SendBulkEmail и предоставляете полное содержимое шаблона в запросе.Тема -> (строка)
Текст -> (строка)
Html -> (строка)
Данные шаблона -> (строка)
Заголовки -> (список)
Список заголовков сообщения, которые будут добавлены к электронному письму.
(структура)
Содержит имя и значение заголовка сообщения, который вы добавляете к электронному письму.
Имя -> (строка)
Имя заголовка сообщения. Имя заголовка сообщения должно соответствовать следующим критериям:
- Может содержать любые печатные символы ASCII (33 - 126) за исключением двоеточия (:).
- Может содержать не более 126 символов.
Значение -> (строка)
Значение заголовка сообщения. Значение заголовка сообщения должно соответствовать следующим критериям:
- Может содержать любые печатные символы ASCII.
- Может содержать не более 870 символов.
Вложения -> (список)
Список вложений, которые нужно включить в ваше электронное письмо. Все получатели получат те же вложения.
(структура)
Содержит метаданные и исходное содержимое вложения.
RawContent -> (бинарный)
ContentDisposition -> (строка)
ATTACHMENT или INLINE.Имя файла -> (строка)
Описание содержимого -> (строка)
ID содержимого -> (строка)
Кодировка передачи содержимого -> (строка)
BASE64 , QUOTED_PRINTABLE , SEVEN_BIT.Тип содержимого -> (строка)
Тип MIME вложения.
Примечание
Пример:application/pdf , image/jpeg
Синтаксис JSON:
{
"Simple": {
"Subject": {
"Data": "string",
"Charset": "string"
},
"Body": {
"Text": {
"Data": "string",
"Charset": "string"
},
"Html": {
"Data": "string",
"Charset": "string"
}
},
"Headers": [
{
"Name": "string",
"Value": "string"
}
...
],
"Attachments": [
{
"RawContent": blob,
"ContentDisposition": "ATTACHMENT"|"INLINE",
"FileName": "string",
"ContentDescription": "string",
"ContentId": "string",
"ContentTransferEncoding": "BASE64"|"QUOTED_PRINTABLE"|"SEVEN_BIT",
"ContentType": "string"
}
...
]
},
"Raw": {
"Data": blob
},
"Template": {
"TemplateName": "string",
"TemplateArn": "string",
"TemplateContent": {
"Subject": "string",
"Text": "string",
"Html": "string"
},
"TemplateData": "string",
"Headers": [
{
"Name": "string",
"Value": "string"
}
...
],
"Attachments": [
{
"RawContent": blob,
"ContentDisposition": "ATTACHMENT"|"INLINE",
"FileName": "string",
"ContentDescription": "string",
"ContentId": "string",
"ContentTransferEncoding": "BASE64"|"QUOTED_PRINTABLE"|"SEVEN_BIT",
"ContentType": "string"
}
...
]
}
}
--tags (список)
Массив объектов, определяющих теги (ключи и значения), которые вы хотите связать с тестом предсказательного размещения входящих сообщений.
(структура)
Объект, определяющий теги, связанные с ресурсом. Тег — это метка, которую вы можете определить и связать с ресурсом. Теги помогают категоризировать и управлять ресурсами различными способами, например, по назначению, владельцу, среде или другим критериям. Один ресурс может иметь до 50 тегов.
Каждый тег состоит из обязательного ключа тега и связанного значения тега, которые вы определяете. Ключ тега — это общая метка, которая служит категорией для более конкретного значения тега. Значение тега выступает в качестве описателя внутри ключа тега. Ключ тега может содержать до 128 символов. Значение тега может содержать до 256 символов. Символы могут быть буквами, цифрами, пробелами или одним из следующих символов: _ . : / = + -. К тегам также применяются следующие ограничения:
- Ключи и значения тегов чувствительны к регистру.
- Для каждого связанного ресурса каждый ключ тега должен быть уникальным, и он может иметь только одно значение.
- Префикс
aws:зарезервирован для использования Amazon Web Services; вы не можете использовать его в ключах или значениях тегов, которые вы определяете. Кроме того, вы не можете редактировать или удалять ключи или значения тегов, использующие этот префикс. Теги, использующие этот префикс, не учитываются при подсчете лимита в 50 тегов на ресурс. - Вы можете связать теги с общедоступными или общими ресурсами, но теги будут доступны только для вашей учетной записи Amazon Web Services, а не для других учетных записей, разделяющих ресурс. Кроме того, теги доступны только для ресурсов, находящихся в указанном регионе Amazon Web Services для вашей учетной записи Amazon Web Services.
Ключ -> (строка)
Значение -> (строка)
Сокращенная синтаксическая запись:
Key=string,Value=string ...
Синтаксис JSON:
[
{
"Key": "string",
"Value": "string"
}
...
]
--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределяют значения, предоставленные JSON. Передача произвольных двоичных значений с помощью значения, предоставленного JSON, невозможна, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если указано без значения или со значением input, выводит пример JSON-ввода, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, выведет пример YAML-ввода, который можно использовать с --cli-input-yaml. Если указано значение output, проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Глобальные параметры
--debug (логическое значение)
Включить отладочную запись в журнал.
--endpoint-url (строка)
Переопределить URL по умолчанию команды на заданный URL.
--no-verify-ssl (логическое значение)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.
--no-paginate (логическое значение)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования выходных данных команды.
- json
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из файла учетных данных.
--region (строка)
Использовать указанный регион. Переопределяет настройки конфигурации/среды.
--version (строка)
Показать версию этого инструмента.
--color (строка)
Включить/отключить цветной вывод.
- on
- off
- auto
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружаться, если этот аргумент предоставлен.
--ca-bundle (строка)
Файл сертификата CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (строка)
Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут представлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (логическое значение)
Отключить кли-пейджер для вывода.
--cli-auto-prompt (логическое значение)
Автоматически запрашивать параметры CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запросы параметров CLI.
Вывод
ReportId -> (строка)
DeliverabilityTestStatus -> (строка)
IN_PROGRESS, значит тест предсказательного размещения входящих сообщений выполняется. Тесты предсказательного размещения входящих сообщений обычно завершаются в течение 24 часов после создания теста. Если статус COMPLETE, значит тест завершен, и вы можете использовать GetDeliverabilityTestReport для просмотра результатов теста.
© Copyright 2025, Amazon Web Services. Created using Sphinx.