本文件 AWS CLI 僅適用於 第 1 版。 如需 第 2 版的相關文件 AWS CLI,請參閱 第 2 版使用者指南 。
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用 的 Amazon SES 範例 AWS CLI
下列程式碼範例示範如何使用 AWS Command Line Interface 搭配 Amazon SES 執行動作和實作常見案例。
Actions 是大型程式的程式碼摘錄,必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數,但您可以在其相關情境中查看內容中的動作。
每個範例都包含完整原始程式碼的連結,您可以在其中找到如何在內容中設定和執行程式碼的指示。
主題
以下程式碼範例顯示如何使用
delete-identity
。
下列範例使用
delete-identity
命令從透過 Amazon SES 驗證的身分清單中刪除身分:
aws ses delete-identity --identityuser@example.com如需驗證的身分詳細資訊,請參閱《Amazon Simple Email Service 開發人員指南》中的「在 Amazon SES 中驗證電子郵件地址和網域」。
"EXAMPLEjcs5xoyqytjsotsijas7236gr", "EXAMPLEjr76cvoc6mysspnioorxsn6ep", "EXAMPLEkbmkqkhlm2lyz77ppkulerm4k" "DkimEnabled": true, "DkimVerificationStatus": "Success" "user@example.com": { "DkimEnabled": false, "DkimVerificationStatus": "NotStarted"如果您使用從未提交進行驗證的身分來呼叫此命令,則該身分不會出現在輸出中。
如需 Easy DKIM 的詳細資訊,請參閱《Amazon Simple Email Service 開發人員指南》中的 Amazon SES 中的 Easy DKIM。
"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此命令會傳回電子郵件意見回饋轉送的狀態,如果適用,也會傳回退信、投訴和交付通知所傳送之 Amazon SNS 主題的 Amazon Resource Name (ARNs)。
如果您使用從未提交進行驗證的身分來呼叫此命令,則該身分不會出現在輸出中。
如需通知的詳細資訊,請參閱《Amazon Simple Email Service 開發人員指南》中的搭配 Amazon SES 使用通知。
Max24HourSend 是您的傳送配額,也就是您在 24 小時期間內可傳送的電子郵件數量上限。傳送配額所反映的是一段時間內的配額。每當您嘗試傳送電子郵件時,Amazon SES 會檢查您在過去的 24 小時內傳送的電子郵件數量。只要您已傳送的電子郵件總數量低於您的配額,您的傳送請求將被接受並將傳送您的電子郵件。
SentLast24Hours 是您在過去 24 小時內傳送的電子郵件數量。
MaxSendRate 是您每秒可傳送的電子郵件數量上限。
請注意,傳送限制依據收件人而定,而非訊息。例如,一封電子郵件中有 10 個收件人,就會佔用 10 個您的傳送配額。
如需詳細資訊,請參閱《Amazon Simple Email Service 開發人員指南》中的「管理您的 Amazon SES 傳送限制」。
"ToAddresses": ["recipient1@example.com", "recipient2@example.com"], "CcAddresses": ["recipient3@example.com"], "BccAddresses": []"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"
message.json:將寄件者和收件者的電子郵件地址取代為您要使用的地址。請注意,必須透過 Amazon SES 驗證寄件者的電子郵件地址。在您取得 Amazon SES 生產存取權之前,除非收件者是 Amazon SES 信箱模擬器,否則您還必須驗證每個收件者的電子郵件地址。如需驗證詳細資訊,請參閱《Amazon Simple Email Service 開發人員指南》中的「在 Amazon SES 中驗證電子郵件地址和網域」。
輸出中的訊息 ID 表示對 send-email 的呼叫成功。
如果您沒有收到電子郵件,請檢查您的垃圾郵件匣。
如需傳送格式化電子郵件的詳細資訊,請參閱《Amazon Simple Email Service 開發人員指南》中「使用 Amazon SES API 傳送格式化電子郵件」。
"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--"如您所見,「資料」是一個長字串,其中包含 MIME 格式的整個原始電子郵件內容,包括名為 attachment.txt 的附件。
將 sender@example.com 和 recipient@example.com 取代為您要使用的地址。請注意,必須透過 Amazon SES 驗證寄件者的電子郵件地址。在您取得 Amazon SES 生產存取權之前,除非收件者是 Amazon SES 信箱模擬器,否則您還必須驗證收件者的電子郵件地址。如需驗證詳細資訊,請參閱《Amazon Simple Email Service 開發人員指南》中的「在 Amazon SES 中驗證電子郵件地址和網域」。
輸出中的訊息 ID 表示對 send-raw-email 的呼叫成功。
如果您沒有收到電子郵件,請檢查您的垃圾郵件匣。
如需傳送電子郵件原始碼的詳細資訊,請參閱《Amazon Simple Email Service 開發人員指南》中的「使用 Amazon SES API 傳送電子郵件原始碼」。
"EXAMPLEq76owjnks3lnluwg65scbemvw", "EXAMPLEi3dnsj67hstzaj673klariwx2", "EXAMPLEwfbtcukvimehexktmdtaz6naj"若要設定 DKIM,您必須使用傳回的 DKIM 權杖,透過指向 Amazon SES 託管的 DKIM 公有金鑰的 CNAME 記錄來更新網域的 DNS 設定。如需詳細資訊,請參閱《Amazon Simple Email Service 開發人員指南》中的 Amazon SES 中的 Easy DKIM。
您必須先驗證您要用於傳送電子郵件的寄件地址或網域來證明您擁有該地址或網域,才可使用 Amazon SES 傳送電子郵件。如果您尚未擁有生產存取權,除了由 Amazon SES 信箱模擬器提供的電子郵件地址外,您仍需驗證任何您傳送電子郵件的收件電子郵件地址。
呼叫 verify-email-identity 之後,電子郵件地址會收到一封驗證電子郵件。使用者必須按一下電子郵件中的連結,以完成驗證程序。
如需詳細資訊,請參閱《Amazon Simple Email Service 開發人員指南》中的「在 Amazon SES 中驗證電子郵件地址」。