SendRawEmail
処理概要
メールヘッダーおよびボディからなるメールメッセージの生のテキストデータを指定してメールを送信します。
SendRawEmail アクションは、マルチパートMIMEメールを送信する場合に便利です。
メッセージの生のテキストは、インターネットのメールの規格に準拠している必要があり、そうでない場合メッセージは送信できません。
送信元のメールアドレスは、検証済みのメールアドレスもしくは検証済みのドメイン下のメールアドレスとしてください。
メッセージの合計サイズ(RawMessage.Dataのbase64デコード後のサイズ)は2MBを超えることはできません。
添付ファイル等メッセージを構成するすべてのデータを含みます。
1通のメッセージにおける TO：、CC：、BCC：のメールアドレス合計数は 50 を超えることはできません。
50個以下のグループに受信者リストを分割し、グループごとにそれぞれリクエストを出してメッセージを送信すれば可能です。
指定するパラメーター
| パラメーター | 型 | 説明 | 必須 |
|---|---|---|---|
| Destinations.member.n | string |
メールの送信先のリスト 使用可能文字: nは1〜50の数字。 「メールアドレス」または「表示名 <メールアドレス>」の形式。 メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号(. + - _ ! # $ % & ' * / = ? ^ ` { | } ~)。 表示名はMIME encode形式(RFC 2047) で指定。 |
|
| RawMessage.Data | string |
送信するメッセージの生のテキストデータをBase64変換したもの。 以下の要件を満たす必要があります。 |
○ |
| Source | string |
メールの送信元。 使用可能文字: 検証済みのメールアドレスもしくは検証済みのドメインのメールアドレスを使用可能。 「メールアドレス」または「表示名 <メールアドレス>」の形式。 メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号(. + - _)。 表示名はMIME encode形式(RFC 2047) で指定。 |
応答フィールド
| フィールド (項目) | 型 | 説明 |
|---|---|---|
| SendRawEmailResponse | structure |
ルート |
| ␣SendRawEmailResult | structure |
結果 |
| ␣␣MessageId | string |
メッセージを一意に特定するために生成されたメッセージID |
| ␣ResponseMetadata | structure |
共通メタ情報 |
| ␣␣RequestId | string |
リクエスト識別子 |
エラー
| コード | メッセージ | タイプ | HTTPステータスコード | 説明 |
|---|---|---|---|---|
| ValidationError | Sender | 400 | パラメーターが不足です。 | |
| InvalidParameterValue | Sender | 400 | 無効な値または範囲外の値を入力パラメーターに指定しています。 | |
| MalformedInput | Sender | 400 | パラメーターが不正です。 | |
| MessageRejected | Sender | 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
Content-type: application/x-www-form-urlencoded
X-Nifty-Date: 20140320T124420Z
Content-Length: 307
Action=SendRawEmail&Version=2010-12-01N2014-05-28&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>
