send-raw-email

Описание

Составляет сообщение электронной почты и немедленно помещает его в очередь для отправки.

Эта операция более гибкая, чем операция SendEmail. При использовании операции SendRawEmail можно указать заголовки сообщения, а также его содержимое. Эта гибкость полезна, например, когда необходимо отправить сообщение MIME с несколькими частями (например, сообщение, содержащее как текстовую, так и HTML-версию). Также можно использовать эту операцию для отправки сообщений, содержащих вложения.

Операция SendRawEmail имеет следующие требования:

• Можно отправлять электронную почту только с подтверждённых адресов электронной почты или доменов. Если вы попытаетесь отправить электронную почту с адреса, который не подтверждён, операция завершится ошибкой «Адрес электронной почты не подтверждён».
• Если ваша учётная запись всё ещё находится в песочнице Amazon SES, вы можете отправлять электронную почту только другим подтверждённым адресам в вашей учётной записи или адресам, связанным с имитатором почтового ящика Amazon SES.
• Максимальный размер сообщения, включая вложения, составляет 10 МБ.
• Каждое сообщение должно содержать как минимум один адрес получателя. Адрес получателя включает любой адрес в строках To:, CC: или BCC:.
• Если вы отправляете одно сообщение нескольким адресам получателя, и один из адресов получателя не имеет допустимого формата (то есть не имеет формат ИмяПользователя@[Поддомен.]Домен.ДоменВысшегоУровня ), Amazon SES отклоняет всё сообщение, даже если другие адреса являются допустимыми.
• Каждое сообщение может содержать до 50 адресов получателей в строках To:, CC: или BCC:. Если вам необходимо отправить одно сообщение более чем 50 получателям, необходимо разбить список адресов получателей на группы по менее чем 50 получателей и отправить отдельные сообщения каждой группе.
• Amazon SES позволяет указать кодировку Content-Transfer-Encoding 8-бит для частей сообщения MIME. Однако, если Amazon SES необходимо изменить содержимое вашего сообщения (например, если используется отслеживание открытий и кликов), кодировка 8-бит не сохраняется. По этой причине мы настоятельно рекомендуем кодировать всё содержимое, которое не является 7-битной ASCII. Более подробную информацию см. в разделе MIME Encoding в Руководстве разработчика Amazon SES.

Кроме того, при использовании операции SendRawEmail следует учитывать следующее:

• Хотя вы можете настраивать заголовки сообщения при использовании операции SendRawEmail, Amazon SES автоматически применяет свои собственные заголовки Message-ID и Date; если вы передали эти заголовки при создании сообщения, они перезаписываются значениями, предоставляемыми Amazon SES.
• Если вы используете авторизацию отправки от имени другого пользователя, SendRawEmail позволяет указать идентификатор кросс-аккаунта для параметров Source, From и Return-Path электронного письма двумя способами: можно передать необязательные параметры SourceArn, FromArn и/или ReturnPathArn, или можно включить следующие заголовки X в заголовок вашего необработанного электронного письма:
  • X-SES-SOURCE-ARN
  • X-SES-FROM-ARN
  • X-SES-RETURN-PATH-ARN

Если вы укажете только параметр SourceIdentityArn, Amazon SES установит адреса From и Return-Path для того же идентификатора, который вы указали.

Для получения дополнительной информации об авторизации отправки см. раздел «Использование авторизации отправки с Amazon SES» в Руководстве разработчика Amazon SES.

• Для каждого отправляемого сообщения общее количество получателей (включая каждого получателя в полях To:, CC: и BCC:) учитывается по отношению к максимальному числу электронных писем, которые вы можете отправить в течение 24 часов (ваш квота на отправку). Более подробную информацию о квотах на отправку в Amazon SES см. в разделе «Управление лимитами отправки Amazon SES» в Руководстве разработчика Amazon SES.

См. также: Документация API AWS

Синтаксис

  send-raw-email
[--source <value>]
[--destinations <value>]
--raw-message <value>
[--from-arn <value>]
[--source-arn <value>]
[--return-path-arn <value>]
[--tags <value>]
[--configuration-set-name <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]

Параметры

--source (строка)

--destinations (список)

Синтаксис:

"string" "string" ...

--raw-message (структура)

Сокращенный синтаксис:

Data=blob

Синтаксис JSON:

{
  "Data": blob
}

--from-arn (строка)

--source-arn (строка)

--return-path-arn (строка)

--tags (список)

Сокращенный синтаксис:

Name=string,Value=string ...

Синтаксис JSON:

[
  {
    "Name": "string",
    "Value": "string"
  }
  ...
]

--configuration-set-name (строка)

--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 (boolean)

Включить отладочную запись журнала.

--endpoint-url (string)

Переопределить URL по умолчанию команды указанным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команд.

• json
• text
• table
• yaml
• yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определённый профиль из файла учетных данных.

--region (string)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (string)

Отобразить версию этого инструмента.

--color (string)

Включить/выключить цветной вывод.

• on
• off
• auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.

--ca-bundle (string)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат 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 (boolean)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (boolean)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматический запрос параметров ввода CLI.

Примеры

Для отправки сырого сообщения электронной почты с помощью Amazon SES

В следующем примере используется команда send-raw-email для отправки сообщения электронной почты с текстовым вложением:

aws ses send-raw-email \
--cli-binary-format raw-in-base64-out \
--raw-message file://message.json

Вывод:

{
   "MessageId": "EXAMPLEf3f73d99b-c63fb06f-d263-41f8-a0fb-d0dc67d56c07-000000"
}

Сырое сообщение — это структура данных JSON, сохранённая в файле message.json в текущем каталоге. Она содержит следующее:

{
   "Data": "From: sender@example.com\nTo: recipient@example.com\nSubject: Test email sent using the AWS CLI (contains an attachment)\nMIME-Version: 1.0\nContent-type: Multipart/Mixed; boundary=\"NextPart\"\n\n--NextPart\nContent-Type: text/plain\n\nThis is the message body.\n\n--NextPart\nContent-Type: text/plain;\nContent-Disposition: attachment; filename=\"attachment.txt\"\n\nThis is the text in the attachment.\n\n--NextPart--"
}

Как видно, «Data» — это одна длинная строка, содержащая всё содержимое сырого сообщения электронной почты в формате MIME, включая вложение под названием attachment.txt.

Замените sender@example.com и recipient@example.com на нужные адреса. Обратите внимание, что адрес электронной почты отправителя должен быть проверен в Amazon SES. До получения доступа к Amazon SES в режиме производства также необходимо проверить адрес электронной почты получателя, если получатель не является симулятором почтового ящика Amazon SES. Дополнительную информацию о проверке см. в разделе Проверка адресов электронной почты и доменов в Amazon SES в Руководстве разработчика Amazon Simple Email Service.

Идентификатор сообщения в выводе указывает на успешное выполнение вызова send-raw-email.

Если вы не получили письмо, проверьте папку «Спам».

Дополнительную информацию об отправке сырых сообщений электронной почты см. в разделе Отправка сырых электронных писем с помощью API Amazon SES в Руководстве разработчика Amazon Simple Email Service.

Вывод

MessageId -> (строка)