send-email

Описание

Создает сообщение электронной почты и немедленно помещает его в очередь для отправки. Для отправки электронного письма с помощью этой операции сообщение должно соответствовать следующим требованиям:

• Сообщение должно быть отправлено с проверенного адреса электронной почты или домена. Если вы попытаетесь отправить электронное письмо с неподтвержденного адреса или домена, операция завершится ошибкой «Адрес электронной почты не подтвержден».
• Если ваш аккаунт всё ещё находится в песочнице Amazon SES, вы можете отправлять только проверенным адресам или доменам, или адресам электронной почты, связанным с Amazon SES Mailbox Simulator. Дополнительную информацию см. в разделе Проверка адресов электронной почты и доменов в руководстве разработчика Amazon SES.
• Максимальный размер сообщения — 10 МБ.
• Сообщение должно содержать хотя бы один адрес получателя электронной почты. Адрес получателя может быть адресом «Кому», «Копия» или «Скрытая копия». Если адрес электронной почты получателя недействителен (то есть не соответствует формату ИмяПользователя@[Поддомен.]Домен.ДоменВерхнегоУровня ), всё сообщение отклоняется, даже если сообщение содержит других получателей, которые действительны.
• Сообщение не может содержать более 50 получателей по полям «Кому», «Копия» и «Скрытая копия». Если вам необходимо отправить электронное письмо более широкой аудитории, вы можете разделить список получателей на группы по 50 человек или меньше и затем несколько раз вызвать операцию SendEmail, чтобы отправить сообщение каждой группе.

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

Синтаксис

  send-email
[--destination <value>]
[--message <value>]
[--reply-to-addresses <value>]
[--return-path <value>]
[--source-arn <value>]
[--return-path-arn <value>]
[--tags <value>]
[--configuration-set-name <value>]
--from<value>
[--to <value>]
[--cc <value>]
[--bcc <value>]
[--subject <value>]
[--text <value>]
[--html <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]

Параметры

--destination (структура)

Сокращенная форма:

ToAddresses=string,string,CcAddresses=string,string,BccAddresses=string,string

Синтаксис JSON:

{
  "ToAddresses": ["string", ...],
  "CcAddresses": ["string", ...],
  "BccAddresses": ["string", ...]
}

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

Сокращенная форма:

Subject={Data=string,Charset=string},Body={Text={Data=string,Charset=string},Html={Data=string,Charset=string}}

Синтаксис JSON:

{
  "Subject": {
    "Data": "string",
    "Charset": "string"
  },
  "Body": {
    "Text": {
      "Data": "string",
      "Charset": "string"
    },
    "Html": {
      "Data": "string",
      "Charset": "string"
    }
  }
}

--reply-to-addresses (список)

Синтаксис:

"string" "string" ...

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

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

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

--tags (список)

Сокращенная форма:

Name=string,Value=string ...

Синтаксис JSON:

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

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

--from (строка)

--to (строка) Адреса электронной почты основных получателей. Вы можете указать несколько получателей, разделив их пробелами

--cc (строка) Адреса электронной почты получателей копии (Cc). Вы можете указать несколько получателей, разделив их пробелами

--bcc (строка) Адреса электронной почты получателей скрытой копии (Bcc). Вы можете указать несколько получателей, разделив их пробелами

--subject (строка) Тема сообщения

--text (строка) Необработанное текстовое тело сообщения

--html (строка) HTML-тело сообщения

--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 версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла непосредственно независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

• base64
• raw-in-base64-out

--no-cli-pager (boolean)

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

--cli-auto-prompt (boolean)

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

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

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

Примеры

Отправка отформатированного электронного письма с помощью Amazon SES

В следующем примере используется команда send-email для отправки отформатированного электронного письма:

aws ses send-email --fromsender@example.com --destination file://destination.json --message file://message.json

Вывод:

{
   "MessageId": "EXAMPLEf3a5efcd1-51adec81-d2a4-4e3f-9fe2-5d85c1b23783-000000"
}

Получатель и сообщение представляют собой JSON-структуры данных, сохраненные в файлах .json в текущем каталоге. Эти файлы таковы:

destination.json:

{
  "ToAddresses":  ["recipient1@example.com", "recipient2@example.com"],
  "CcAddresses":  ["recipient3@example.com"],
  "BccAddresses": []
}

message.json:

{
   "Subject": {
       "Data": "Test email sent using the AWS CLI",
       "Charset": "UTF-8"
   },
   "Body": {
       "Text": {
           "Data": "This is the message body in text format.",
           "Charset": "UTF-8"
       },
       "Html": {
           "Data": "This message body contains HTML formatting. It can, for example, contain links like this one: <a class=\"ulink\" href=\"http://docs.aws.amazon.com/ses/latest/DeveloperGuide\" target=\"_blank\">Amazon SES Developer Guide</a>.",
           "Charset": "UTF-8"
       }
   }
}

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

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

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

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

Вывод

MessageId -> (строка)