を使用した Amazon SES の例 AWS CLI

次のコード例は、Amazon AWS Command Line Interface でを使用してアクションを実行し、一般的なシナリオを実装する方法を示していますSES。

アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には、完全なソースコードへのリンクが含まれています。ここでは、コンテキストでコードを設定および実行する方法の手順を確認できます。

トピック

アクション

アクション

次のコード例は、delete-identity を使用する方法を示しています。

AWS CLI

ID を削除するには

次の例では、 delete-identity コマンドを使用して、Amazon で検証された ID のリストから ID を削除しますSES。


aws ses delete-identity --identity user@example.com

検証された ID の詳細については、「Amazon Simple Email Service デベロッパーガイドSES」の「Amazon での E メールアドレスとドメインの検証」を参照してください。

API 詳細については、AWS CLI 「コマンドリファレンスDeleteIdentity」の「」を参照してください。

次の例は、get-identity-dkim-attributes を使用する方法を説明しています。

AWS CLI

ID のリストの Amazon SES Easy DKIM 属性を取得するには

次の例では、 get-identity-dkim-attributes コマンドを使用して ID のリストの Amazon SES Easy DKIM 属性を取得します。


aws ses get-identity-dkim-attributes --identities "example.com" "user@example.com"

出力:


{
   "DkimAttributes": {
       "example.com": {
           "DkimTokens": [
               "EXAMPLEjcs5xoyqytjsotsijas7236gr",
               "EXAMPLEjr76cvoc6mysspnioorxsn6ep",
               "EXAMPLEkbmkqkhlm2lyz77ppkulerm4k"
           ],
           "DkimEnabled": true,
           "DkimVerificationStatus": "Success"
       },
       "user@example.com": {
           "DkimEnabled": false,
           "DkimVerificationStatus": "NotStarted"
       }
   }
}

検証のために、送信したことがない ID を使用してこのコマンドを呼び出した場合、その ID は出力に表示されません。

Easy の詳細についてはDKIM、「Amazon Simple Email Service デベロッパーガイドSES」の「Amazon DKIMでの Easy」を参照してください。

API 詳細については、AWS CLI 「コマンドリファレンスGetIdentityDkimAttributes」の「」を参照してください。

次のコード例は、get-identity-notification-attributes を使用する方法を示しています。

AWS CLI

ID のリストの Amazon SES通知属性を取得するには

次の例では、 get-identity-notification-attributes コマンドを使用して、アイデンティティのリストの Amazon SES通知属性を取得します。


aws ses get-identity-notification-attributes --identities "user1@example.com" "user2@example.com"

出力:


{
   "NotificationAttributes": {
       "user1@example.com": {
           "ForwardingEnabled": false,
           "ComplaintTopic": "arn:aws:sns:us-east-1:EXAMPLE65304:MyTopic",
           "BounceTopic": "arn:aws:sns:us-east-1:EXAMPLE65304:MyTopic",
           "DeliveryTopic": "arn:aws:sns:us-east-1:EXAMPLE65304:MyTopic"
       },
       "user2@example.com": {
           "ForwardingEnabled": true
       }
   }
}

このコマンドは、E メールフィードバック転送のステータスと、該当する場合は、バウンス、苦情、配信通知が送信される Amazon SNSトピックの Amazon リソースネーム (ARNs) を返します。

検証のために、送信したことがない ID を使用してこのコマンドを呼び出した場合、その ID は出力に表示されません。

通知の詳細については、「Amazon Simple Email Service デベロッパーガイドSES」の「Amazon での通知の使用」を参照してください。

API 詳細については、AWS CLI 「コマンドリファレンスGetIdentityNotificationAttributes」の「」を参照してください。

次の例は、get-identity-verification-attributes を使用する方法を説明しています。

AWS CLI

ID のリストの Amazon SES検証ステータスを取得するには

次の例では、 get-identity-verification-attributes コマンドを使用して、アイデンティティのリストの Amazon SES検証ステータスを取得します。


aws ses get-identity-verification-attributes --identities "user1@example.com" "user2@example.com"

出力:


{
   "VerificationAttributes": {
       "user1@example.com": {
           "VerificationStatus": "Success"
       },
       "user2@example.com": {
           "VerificationStatus": "Pending"
       }
   }
}

検証のために、送信したことがない ID を使用してこのコマンドを呼び出した場合、その ID は出力に表示されません。

API 詳細については、AWS CLI 「コマンドリファレンスGetIdentityVerificationAttributes」の「」を参照してください。

次のコード例は、get-send-quota を使用する方法を示しています。

AWS CLI

Amazon SES送信制限を取得するには

次の例では、 get-send-quota コマンドを使用して Amazon SES送信制限を返します。


aws ses get-send-quota

出力:


{
   "Max24HourSend": 200.0,
   "SentLast24Hours": 1.0,
   "MaxSendRate": 1.0
}

Max24HourSend は送信クォータです。これは、24 時間以内に送信できる E メールの最大数です。送信クォータには、期間の推移が反映されます。E メールを送信しようとするたびに、Amazon は過去 24 時間に送信された E メールの数SESを確認します。送信済みのメールの合計数がクォータ未満であれば、送信リクエストは受理され、E メールが送信されます。

SentLast24Hours、過去 24 時間に送信された E メールの数です。

MaxSendRate は、1 秒あたりに送信できる E メールの最大数です。

送信制限は、メッセージ数ではなく、受取人数に基づいていることに注意してください。例えば、受取人数が 10 人である E メールは、送信クォータに対しては 10 通とカウントされます。

詳細については、「Amazon Simple Email Service デベロッパーガイド」の「Amazon SES 送信制限の管理」を参照してください。

API 詳細については、AWS CLI 「コマンドリファレンスGetSendQuota」の「」を参照してください。

次のコード例は、get-send-statistics を使用する方法を示しています。

AWS CLI

Amazon SES送信統計を取得するには

次の例では、 get-send-statistics コマンドを使用して Amazon SES送信統計を返します。


aws ses get-send-statistics

出力:


{
   "SendDataPoints": [
       {
           "Complaints": 0,
           "Timestamp": "2013-06-12T19:32:00Z",
           "DeliveryAttempts": 2,
           "Bounces": 0,
           "Rejects": 0
       },
       {
           "Complaints": 0,
           "Timestamp": "2013-06-12T00:47:00Z",
           "DeliveryAttempts": 1,
           "Bounces": 0,
           "Rejects": 0
       }
   ]
}

結果は、送信アクティビティの過去 2 週間を表すデータポイントのリストです。リスト内の各データポイントには、15 分間隔での統計が含まれます。

この例では、過去 2 週間にユーザーが送信した E メールが 15 分間隔で 2 つしかなかったため、データポイントは 2 つしかありません。

詳細については、「Amazon Simple Email Service デベロッパーガイド」の「Amazon SES使用状況統計のモニタリング」を参照してください。

API 詳細については、AWS CLI 「コマンドリファレンスGetSendStatistics」の「」を参照してください。

次のコード例は、list-identities を使用する方法を示しています。

AWS CLI

特定の AWS アカウントのすべての ID (E メールアドレスとドメイン) を一覧表示するには

次の例では、 list-identities コマンドを使用して、Amazon での検証のために送信されたすべての ID を一覧表示しますSES。


aws ses list-identities

出力:


{
    "Identities": [
      "user@example.com",
      "example.com"
    ]
}

返されるリストには、検証ステータス (検証済み、検証保留中、失敗など) に関係なく、すべての ID が含まれます。

この例では、identity-type パラメータを指定しなかったため、E メールアドレスおよびドメインが返されます。

検証の詳細については、「Amazon Simple Email Service デベロッパーガイドSES」の「Amazon での E メールアドレスとドメインの検証」を参照してください。

API 詳細については、AWS CLI 「コマンドリファレンスListIdentities」の「」を参照してください。

次の例は、send-email を使用する方法を説明しています。

AWS CLI

Amazon を使用してフォーマットされた E メールを送信するには SES

以下の例では、send-email コマンドを使用してフォーマットされた E メールを送信しています。


aws ses send-email --from sender@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"
       }
   }
}

送信者と受信者の E メールアドレスを、使用したい E メールアドレスに置き換えます。送信者の E メールアドレスは Amazon で検証する必要があることに注意してくださいSES。Amazon への本番アクセスが許可されるまでSES、受信者が Amazon SESメールボックスシミュレーターでない限り、各受信者の E メールアドレスも確認する必要があります。検証の詳細については、「Amazon Simple Email Service デベロッパーガイドSES」の「Amazon での E メールアドレスとドメインの検証」を参照してください。

出力のメッセージ ID は、send-email の呼び出しが成功したことを示しています。

E メールが届かない場合は、迷惑メールフォルダを確認してください。

フォーマットされた E メールの送信の詳細については、「Amazon SES API Simple Email Service デベロッパーガイド」の「Amazon を使用したフォーマットされた E メールの送信」を参照してください。

API 詳細については、AWS CLI 「コマンドリファレンスSendEmail」の「」を参照してください。

次の例は、send-raw-email を使用する方法を説明しています。

AWS CLI

Amazon を使用して raw E メールを送信するには SES

次の例では、 send-raw-email コマンドを使用してTXT、添付ファイルを含む E メールを送信します。


aws ses send-raw-email --raw-message file://message.json

出力:


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

raw メッセージは、現在のディレクトリにあるという名前message.jsonのファイルに保存された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」は、添付ファイルである attachment.txt など、未加工の E メールコンテンツ全体を MIME 形式で含む 1 つの長い文字列です。

sender@example.com と recipient@example.com は、使用するアドレスに置き換えてください。送信者の E メールアドレスは Amazon で検証する必要があることに注意してくださいSES。Amazon への本番稼働アクセスが許可されるまでSES、受信者が Amazon SESメールボックスシミュレーターでない限り、受信者の E メールアドレスも確認する必要があります。検証の詳細については、「Amazon Simple Email Service デベロッパーガイドSES」の「Amazon での E メールアドレスとドメインの検証」を参照してください。

出力のメッセージ ID は、への呼び出しが成功 send-raw-email したことを示します。

E メールが届かない場合は、迷惑メールフォルダを確認してください。

未加工の E メールの送信の詳細については、Amazon Simple Email Service デベロッパーガイドのSESAPI「Amazon を使用した未加工の E メールの送信」を参照してください。

API 詳細については、AWS CLI 「コマンドリファレンスSendRawEmail」の「」を参照してください。

次の例は、set-identity-dkim-enabled を使用する方法を説明しています。

AWS CLI

Amazon SES検証済み ID DKIMで Easy を有効または無効にするには

次の例では、 set-identity-dkim-enabled コマンドを使用して、検証済みの E メールアドレスDKIMに対してを無効にします。


aws ses set-identity-dkim-enabled --identity user@example.com --no-dkim-enabled

Easy の詳細についてはDKIM、「Amazon Simple Email Service デベロッパーガイドSES」の「Amazon DKIMでの Easy」を参照してください。

API 詳細については、AWS CLI 「コマンドリファレンスSetIdentityDkimEnabled」の「」を参照してください。

次の例は、set-identity-feedback-forwarding-enabled を使用する方法を説明しています。

AWS CLI

Amazon SES検証済み ID のバウンスと苦情の E メールフィードバック転送を有効または無効にするには

次の例では、 set-identity-feedback-forwarding-enabled コマンドを使用して、検証済みの E メールアドレスがバウンス通知と苦情通知を E メールで受信できるようにします。


aws ses set-identity-feedback-forwarding-enabled --identity user@example.com --forwarding-enabled

Amazon SNSまたは E メールのフィードバック転送を介してバウンス通知と苦情通知を受け取る必要があるため、バウンス通知と苦情通知の両方に Amazon SNSトピックを選択した場合のみ、E メールのフィードバック転送を無効にすることができます。

通知の詳細については、「Amazon Simple Email Service デベロッパーガイドSES」の「Amazon での通知の使用」を参照してください。

API 詳細については、AWS CLI 「コマンドリファレンスSetIdentityFeedbackForwardingEnabled」の「」を参照してください。

次のコード例は、set-identity-notification-topic を使用する方法を示しています。

AWS CLI

Amazon が検証済み ID のバウンス、苦情、配信通知SESを発行する Amazon SNSトピックを設定するには

次の例では、 set-identity-notification-topic コマンドを使用して、検証済みの E メールアドレスがバウンス通知を受信する Amazon SNSトピックを指定します。


aws ses set-identity-notification-topic --identity user@example.com --notification-type Bounce --sns-topic arn:aws:sns:us-east-1:EXAMPLE65304:MyTopic

通知の詳細については、「Amazon Simple Email Service デベロッパーガイドSES」の「Amazon での通知の使用」を参照してください。

API 詳細については、AWS CLI 「コマンドリファレンスSetIdentityNotificationTopic」の「」を参照してください。

次の例は、verify-domain-dkim を使用する方法を説明しています。

AWS CLI

Amazon とDKIM署名するための検証済みドメインのDKIMトークンを生成するには SES

次の例では、 verify-domain-dkim コマンドを使用して、Amazon で検証されたドメインのDKIMトークンを生成しますSES。


aws ses verify-domain-dkim --domain example.com

出力:


{
   "DkimTokens": [
       "EXAMPLEq76owjnks3lnluwg65scbemvw",
       "EXAMPLEi3dnsj67hstzaj673klariwx2",
       "EXAMPLEwfbtcukvimehexktmdtaz6naj"
   ]
}

を設定するにはDKIM、返されたDKIMトークンを使用して、Amazon がホストするDKIMパブリックキーを指すCNAMEレコードでドメインDNSの設定を更新する必要がありますSES。詳細については、「Amazon Simple Email Service デベロッパーガイドSES」の「Amazon DKIMで簡単」を参照してください。

API 詳細については、AWS CLI 「コマンドリファレンスVerifyDomainDkim」の「」を参照してください。

次のコード例は、verify-domain-identity を使用する方法を示しています。

AWS CLI

Amazon でドメインを検証するには SES

以下の例では、verify-domain-identity コマンドを使用してドメインを認証しています。


aws ses verify-domain-identity --domain example.com

出力:


{
   "VerificationToken": "eoEmxw+YaYhb3h3iVJHuXMJXqeu1q1/wwmvjuEXAMPLE"
}

ドメインの検証を完了するには、返された検証トークンを含むTXTレコードをドメインDNSの設定に追加する必要があります。詳細については、「Amazon Simple Email Service デベロッパーガイドSES」の「Amazon でのドメインの検証」を参照してください。

API 詳細については、AWS CLI 「コマンドリファレンスVerifyDomainIdentity」の「」を参照してください。

次のコード例は、verify-email-identity を使用する方法を示しています。

AWS CLI

Amazon で E メールアドレスを確認するには SES

以下の例では、verify-email-identity コマンドを使用して E メールアドレスを認証しています。


aws ses verify-email-identity --email-address user@example.com

Amazon を使用して E メールを送信する前にSES、E メールを送信するアドレスまたはドメインを確認して、所有していることを証明する必要があります。本番稼働用アクセスがまだない場合は、Amazon SESメールボックスシミュレーターから提供された E メールアドレスを除き、E メールを送信する E メールアドレスも確認する必要があります。

verify-email-identity が呼び出されると、E メールアドレスに検証 E メールが送信されます。ユーザーは、E メールのリンクをクリックして、検証プロセスを完了する必要があります。

詳細については、「Amazon Simple Email Service デベロッパーガイドSES」の「Amazon での E メールアドレスの検証」を参照してください。

API 詳細については、AWS CLI 「コマンドリファレンスVerifyEmailIdentity」の「」を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

Service Quotas

Shield