ESS:SendRawEmail
概要
メールヘッダーおよびボディからなるメールメッセージの生のテキストデータを指定してメールを送信します。
SendRawEmail アクションは、マルチパートMIMEメールを送信する場合に便利です。
メッセージの生のテキストは、インターネットのメールの規格に準拠している必要があり、そうでない場合メッセージは送信できません。
送信元のメールアドレスは、検証済みのメールアドレスもしくは検証済みのドメイン下のメールアドレスとしてください。
メッセージの合計サイズ(RawMessage.Dataのbase64デコード後のサイズ)は2MBを超えることはできません。
添付ファイル等メッセージを構成するすべてのデータを含みます。
1通のメッセージにおける TO:、CC:、BCC:のメールアドレス合計数は 50 を超えることはできません。
50個以下のグループに受信者リストを分割し、グループごとにそれぞれリクエストを出してメッセージを送信すれば可能です。
リクエストパラメーター
要素名 | 説明 | 必須 | 値 | 最大値 | デフォルト値 | 備考 |
---|---|---|---|---|---|---|
Destinations.member.N | メールの送信先のリスト N は1〜50の数字。 「メールアドレス」または「表示名 <メールアドレス>」の形式。メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号( . + - _ ! # $ % & ' * / = ? ^ ` { | } ~ )。表示名はMIME encode形式(RFC 2047) で指定。 |
文字列 | − | − | ||
RawMessage.Data | 送信するメッセージの生のテキストデータをBase64変換したもの。 以下の要件を満たす必要があります。
|
○ | 文字列 | − | − | |
Source | メールの送信元
|
文字列 | − | − | 検証済みのメールアドレスもしくは検証済みのドメインのメールアドレス |
レスポンス
要素名 | 説明 | 値 | 備考 |
---|---|---|---|
SendRawEmailResponse | ルート | − | |
SendRawEmailResult | 結果 | − | |
MessageId | メッセージを一意に特定するために生成されたメッセージID | 文字列 | |
ResponseMetadata | 共通メタ情報 | − |
エラー
エラー種別 | HTTPステータスコード | 説明 |
---|---|---|
ValidationError | 400 | パラメーターが不足です。 |
InvalidParameterValue | 400 | 無効な値または範囲外の値を入力パラメーターに指定しています。 |
MalformedInput | 400 | パラメーターが不正です。 |
MessageRejected | 400 | アクションに失敗しメッセージは送信できませんでした。付帯するエラー情報を見て原因を確認してください。 |
サンプル
リクエストサンプル
POST / HTTP/1.1
Authorization: NIFTY4-HMAC-SHA256 Credential=<Credential>/20140320/east-1/email/nifty4_request, SignedHeaders=host;x-nifty-date, Signature=<Signature>
Host: ess.api.nifcloud.com
X-Nifty-Date: 20140320T124420Z
Content-Length: 307
Action=SendRawEmail&Version=2010-12-01&RawMessage.Data=RnJvbTogdGVzdDAwMUXlc3・・・・・
レスポンスサンプル
HTTP/1.1 200 OK
Date: Thu, 20 Mar 2014 07:05:21 GMT
x-amzn-RequestId: 1410d27a-d03b-4bb9-9130-a0ecfdb50ded
X-Nifty-RequestId: 1410d27a-d03b-4bb9-9130-a0ecfdb50ded
Content-Type: text/xml
Content-Length: 278
Connection: close
<SendRawEmailResponse>
<SendRawEmailResult>
<MessageId>00000130feba5b-341e-4afa-9526-48ebd88e2886-000000</MessageId>
</SendRawEmailResult>
<ResponseMetadata>
<RequestId>1410d27a-d03b-4bb9-9130-a0ecfdb50ded</RequestId>
</ResponseMetadata>
</SendRawEmailResponse>