使用 Amazon SES 帳戶級別禁止列表 - Amazon Simple Email Service

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

使用 Amazon SES 帳戶級別禁止列表

引入了 Amazon SES 帳戶級別禁止列表,以便客戶可以創建和控制自己的禁止列表並管理其聲譽,因此,您的帳戶級別禁止列表僅適用於您的帳戶。SES主控台中的帳戶層級隱藏清單介面可讓您輕鬆管理帳戶層級隱藏清單中的地址,包括新增或移除地址的大量動作。

您的SES帳戶層級隱藏清單適用於您目前 AWS 帳戶 的帳戶。 AWS 區域您可以使用 SES API v2 或主控台,在帳戶層級隱藏清單中個別或大量新增或移除地址。

注意

若要大量新增或移除地址,您必須具備生產存取權。若要進一步了解沙箱,請參閱 請求生產存取權 (移出 Amazon SES沙盒)

Amazon SES 帳戶級別禁止清單注意事項

當您使用您的帳戶層級禁止名單時,應考量下列因素:

  • 如果您在 2019 年 11 月 25 日SES之後開始使用 Amazon,您的帳戶預設會針對退信和投訴使用帳戶層級禁止清單。如果您在此日期SES之前開始使用,則必須使用中的PutAccountSuppressionAttributes作業來啟用此功能SESAPI。

  • 如果您嘗試將訊息傳送至帳戶層級隱藏清單上的地址,且其隱藏原因符合您帳戶層級隱藏設定所選擇的相同抑制原因,則會SES接受該訊息,但不會傳送訊息 — 不過,如果不相符,則會傳送訊息。SES以下提供的範例目的在於協助清楚說明這點:

    • 您已將帳戶層級隱藏設定設定為「僅限彈回數」的抑制原因,SES將不會嘗試傳送帳戶層級隱藏清單中的地址,並且抑制原因為「退回」。

    • 您已設定帳戶層級的隱藏設定,並禁止退信和投訴的原因,SES將不會嘗試傳送帳戶層級禁止清單中的地址,並不會因為退信或投訴的原因而嘗試傳送。

    • 您已將帳戶層級的隱藏設定設定為「僅限退件」的隱藏原因,SES將會嘗試在帳戶層級隱藏清單中的地址傳送,並以「投訴」的隱藏原因(因為在這種情況下,它們不符合)。

  • SES不會將您傳送至帳戶層級禁止清單上地址的郵件計入「信譽評等」。 BounceRate聲譽。 ComplaintRate您帳戶的 AWS/SES命名空間中的度量。這類訊息會計入 AWS/SES命名空間中的「退回」或「投訴」量度下。

  • 如果地址位於全域禁止清單中,但不在您的帳戶層級禁止清單上 (也就是說您要傳送給該地址),而您確實傳送給該地址,仍SES會嘗試傳送;不過,如果該地址退回,它仍會計入您帳戶的跳出率以及每日傳送配額。

  • SES將您傳送至帳戶層級禁止清單上地址的郵件計入每日傳送配額。

  • 除非您予以移除,否則您的帳戶層級禁止名單中的電子郵件地址會持續保留。

  • 如果您的帳戶傳送電子郵件功能已暫停,90 天後SES會自動刪除帳戶層級禁止清單中的地址。如果您的帳戶傳送電子郵件的功能在 90 天的期間結束之前已經恢復,則不會刪除名單中的地址。

  • Gmail 不會向您提供投訴資料SES。如果收件人使用 Gmail web 用戶端中的 Spam (垃圾郵件) 按鈕,將他們收到來自您的郵件回報為垃圾郵件,這些郵件則不會新增至您的帳戶層級禁止名單。

  • 如果您的帳戶位於沙箱中,您可以啟用帳戶層級禁止清單。SES不過,除非您的帳戶從沙箱中移除,否則您無法使用PutSuppressedDestinationCreateImportJob操作。若要進一步了解沙箱,請參閱 請求生產存取權 (移出 Amazon SES沙盒)

  • 只有硬退信會新增至您的帳戶層級禁止名單。如需有關軟退信和硬退信之間的差異資訊,請參閱 Amazon 發SES送電子郵件後

  • 當您使用帳戶層級隱藏清單時,也會SES將導致硬退回的位址新增至全域隱藏清單。

啟用 Amazon SES 帳戶級別禁止列表

您可以使用 Amazon SES API v2 中的PutAccountSuppressionAttributes操作來啟用和設定帳戶層級禁止清單。您可以使用 AWS CLI快速且輕鬆地設定此設定。如需安裝與設定 AWS CLI的詳細資訊,請參閱 AWS Command Line Interface 使用者指南

設定帳戶層級的隱藏清單 AWS CLI
  • 在命令列中輸入以下命令:

    Linux, macOS, or Unix
    aws sesv2 put-account-suppression-attributes \ --suppressed-reasons BOUNCE COMPLAINT
    Windows
    aws sesv2 put-account-suppression-attributes ` --suppressed-reasons BOUNCE COMPLAINT

    若要啟用您的帳戶層級禁止名單,您必須為 suppressed-reasons 參數至少指定一個原因。如上述範例所示,您可以指定 BOUNCECOMPLAINT,也可以指定兩者。

若要使用主控台設定帳戶層級隱藏清單:SES
  1. 登錄 AWS Management Console 並在打開 Amazon SES 控制台https://console.aws.amazon.com/ses/

  2. 在導覽窗格中的 Configuration (組態) 下,選擇 Suppression list (禁止名單)。

  3. Account-level settings (帳戶層級設定) 窗格中,選擇 Edit (編輯)。

  4. Suppression list (禁止名單) 中,勾選 Enabled (已啟用) 方塊。

  5. Suppression reasons (禁止原因) 下,選取收件人電子郵件地址應自動新增至帳戶層級禁止名單的其中一個原因。

  6. 選擇 Save changes (儲存變更)。

啟用組態集的 Amazon SES 帳戶層級禁止清單

您也可以設定 Amazon SES 帳戶層級隱藏,使其僅適用於特定組態集。當您執行這項操作時,只有在您傳送導致退信或投訴事件之電子郵件時已指定組態集的情況下,地址才會新增到禁止名單。

注意

下列程序假設您已安裝 AWS CLI。若要取得有關安裝和配置的更多資訊 AWS CLI,請參閱《AWS Command Line Interface 使用者指南》

若要使用 AWS CLI
  • 在命令列中輸入以下命令:

    Linux, macOS, or Unix
    aws sesv2 put-configuration-set-suppression-options \ --configuration-set-name configSet \ --suppressed-reasons BOUNCE COMPLAINT
    Windows
    aws sesv2 put-configuration-set-suppression-options ` --configuration-set-name configSet ` --suppressed-reasons BOUNCE COMPLAINT

    在前面的例子中,替換 configSet 使用應使用您帳戶層級隱藏清單的組態集名稱。

若要使用主控台設定組態集的帳戶層級隱藏清單:SES
  1. 登錄 AWS Management Console 並在打開 Amazon SES 控制台https://console.aws.amazon.com/ses/

  2. 在導覽窗格中的 Configuration (組態) 下,選擇 Configuration sets (組態集)。

  3. Configuration sets (組態集) 中,選擇您要使用自訂禁止設定的組態集名稱。

  4. Suppression list options (禁止名單選項) 窗格中,選擇 Edit (編輯)。

  5. Suppression list options (禁止名單選項) 區段提供了一個決策集,用於定義自訂禁止,從使用此組態集覆寫帳戶層級禁止的選項開始。組態集層級禁止邏輯圖將幫助您了解覆寫組合的效果。您可以組合這些多層級覆寫選擇,以實作三種不同層級的禁止:

    1. 使用帳戶層級禁止:請勿覆寫您的帳戶層級禁止,也不要實作任何組態集層級禁止 - 基本上,任何使用此組態集傳送的電子郵件都只會使用您的帳戶層級禁止。若要執行此作業:

      1. Suppression list settings (禁止名單設定) 中,取消勾選 Override account level settings (覆寫帳戶層級設定) 方塊。

    2. 請勿使用任何禁止:覆寫您的帳戶層級禁止,而不啟用任何組態集層級禁止 - 這表示使用此組態集傳送的任何電子郵件都不會使用您的帳戶層級禁止;換句話說,所有禁止都會取消。若要執行此作業:

      1. Suppression list settings (禁止名單設定) 中,勾選 Override account level settings (覆寫帳戶層級設定) 方塊。

      2. Suppression list (禁止名單) 中,取消勾選 Enabled (已啟用) 方塊。

    3. 使用組態集層級禁止:使用此組態集中定義的自訂禁止清單設定來覆寫您的帳戶層級禁止 - 這表示使用此組態集傳送的任何電子郵件都只會使用自己的禁止設定,並忽略任何帳戶層級禁止設定。若要執行此作業:

      1. Suppression list settings (禁止名單設定) 中,勾選 Override account level settings (覆寫帳戶層級設定) 方塊。

      2. Suppression list (禁止名單) 中,勾選 Enabled (已啟用)。

      3. Specify the reason(s)... (指定原因…) 中,選取此組態集要使用的其中一個禁止原因。

  6. 選擇 Save changes (儲存變更)。

將個別電子郵件地址新增至 Amazon SES 帳戶層級禁止清單

您可以使用 v2 中的PutSuppressedDestination操作,將個別地址新增至 Amazon SES 帳戶層級禁止清單。SES API您可以新增到您的帳戶層級禁止名單的地址數目沒有限制。

注意

下列程序假設您已安裝 AWS CLI。若要取得有關安裝和配置的更多資訊 AWS CLI,請參閱《AWS Command Line Interface 使用者指南》

使用 AWS CLI將個別地址新增至您的帳戶層級禁止名單
  • 在命令列中輸入以下命令:

    Linux, macOS, or Unix
    aws sesv2 put-suppressed-destination \ --email-address recipient@example.com \ --reason BOUNCE
    Windows
    aws sesv2 put-suppressed-destination ` --email-address recipient@example.com ` --reason BOUNCE

    在前面的例子中,替換 recipient@example.com 使用您要添加到帳戶級別禁止列表的電子郵件地址,以及 BOUNCE 與您將地址添加到抑制列表的原因(可接受的值是BOUNCECOMPLAINT)。

若要使用主控台將個別地址新增至您的帳戶層級隱藏清單:SES
  1. 登錄 AWS Management Console 並在打開 Amazon SES 控制台https://console.aws.amazon.com/ses/

  2. 在導覽窗格中的 Configuration (組態) 下,選擇 Suppression list (禁止名單)。

  3. 禁止名單窗格中,選擇新增電子郵件地址

  4. Email address (電子郵件地址) 中輸入電子郵件地址,接著在 Suppression reason (禁止原因) 選取原因 - 如果您需要輸入更多地址,請選擇 Add another address (新增其他地址),並對每個額外的電子郵件地址重複執行以上動作。

  5. 輸入地址後,請檢閱輸入的準確性。如果您決定任何輸入項不應成為此提交的一部分,請選擇其 Remove (移除) 按鈕。

  6. 選擇儲存變更,將輸入的電子郵件地址新增至帳號層級禁止名單。

將電子郵件地址批量添加到您的 Amazon SES 帳戶級別禁止列表

您可以先將聯絡人清單上傳到 Amazon S3 物件,然後使用 Amazon SES API v2 中的CreateImportJob操作,以大量新增地址。

注意
  • 您可以新增至帳戶層級禁止清單的地址數量沒有限制,但是每API次呼叫 Amazon S3 物件中的大量新增地址限制為 100,000 個。

  • 如果您的資料來源是 S3 儲存貯體,它必須存在於您要匯入的相同區域中。

若要將大量電子郵件地址新增至帳戶層級禁止名單,請完成下列步驟。

  • 以或格式將您的通訊清單上傳到 Amazon S3 CSV 物JSON件。

    CSV添加地址的格式示例:

    recipient1@example.com,BOUNCE

    recipient2@example.com,COMPLAINT

    僅支持換行符分隔的JSON文件。在此格式中,每一行都是包含個別位址定義的完整JSON物件。

    JSON添加地址的格式示例:

    {"emailAddress":"recipient1@example.com","reason":"BOUNCE"}

    {"emailAddress":"recipient2@example.com","reason":"COMPLAINT"}

    在上述範例中,取代 recipient1@example.com 以及 recipient2@example.com 包含您要新增至帳戶層級隱藏清單的電子郵件地址。將地址新增至禁止名單的可接受原因是「BOUNCE」和「COMPLAINT」。

  • SES授予讀取 Amazon S3 物件的權限。

    套用至 Amazon S3 儲存貯體時,下列政策會SES授予讀取該儲存貯體的權限。如需將政策附加至 Amazon S3 儲存貯體的詳細資訊,請參閱《Amazon Simple Storage Service 使用者指南》中的使用儲存貯體政策和使用者政策

    { "Version": "2012-10-17", "Statement": [ { "Sid": "AllowSESGet", "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "s3:GetObject", "Resource": "arn:aws:s3:::BUCKET-NAME/OBJECT-NAME", "Condition": { "StringEquals": { "aws:Referer": "AWSACCOUNTID" } } } ] }
  • SES授予使用 AWS KMS 金鑰的權限。

    如果 Amazon S3 物件使用 AWS KMS 金鑰加密,您需要授予 Amazon 使用 AWS KMS 金鑰的SES權限。SES只能從客戶管理的金鑰取得權限,而不是預設KMS金鑰。您必須在金鑰政策中新增陳述式,以SES授予使用客戶管理金鑰的權限。

    將以下政策聲明粘貼到密鑰策略中,以SES允許使用客戶託管的密鑰。

    { "Sid": "AllowSESToDecrypt", "Effect": "Allow", "Principal": { "Service":"ses.amazonaws.com" }, "Action": [ "kms:Decrypt", ], "Resource": "*" }
  • 使用 SES API v2 中的CreateImportJob操作。

注意

下列範例假設您已安裝 AWS CLI。若要取得有關安裝和配置的更多資訊 AWS CLI,請參閱《AWS Command Line Interface 使用者指南》

在命令列輸入下列命令。Replace (取代) s3bucket 與 Amazon S3 存儲桶的名稱和 s3object 與 Amazon S3 對象的名稱。

aws sesv2 create-import-job --import-destination SuppressionListDestination={SuppressionListImportAction=PUT} --import-data-source S3Url=s3://s3bucket/s3object,DataFormat=CSV
若要使用主控台將電子郵件地址大量新增至帳戶層級隱藏清單:SES
  1. 登錄 AWS Management Console 並在打開 Amazon SES 控制台https://console.aws.amazon.com/ses/

  2. 在導覽窗格中的 Configuration (組態) 下,選擇 Suppression list (禁止名單)。

  3. Suppression list (禁止名單) 表格中,展開 Bulk actions (大量動作) 按鈕,然後選取 Add email addresses in bulk (大量新增電子郵件地址)。

  4. Bulk action specifications (大量動作規格) 中,選取 (a)Choose file from S3 bucket (從 S3 儲存貯體選擇檔案) 或 (b)Import from file (從檔案匯入) - 各種匯入方法的程序如下:

    1. Choose file from S3 bucket (從 S3 儲存貯體選擇檔案) - 如果您的來源檔案已儲存在 Amazon S3 儲存貯體中

      1. 如果您知道要使用URI的 Amazon S3 儲存貯體,請在 Amazon S3 URI 欄位中輸入該儲存貯體;否則,請選擇瀏覽 S3

        1. Buckets (儲存貯體) 中,選取 S3 儲存貯體的名稱。

        2. Objects (物件) 中,選取檔案的名稱,然後選取 Choose (選擇) - 您將會回到 Bulk action specifications (大量動作規格)。

        3. (選用 ) 如果您想要前往 Amazon S3 主控台查看有關 S3 物件的詳細資訊,請選擇 View (檢視)。

      2. File format (檔案格式) 中,選取您選擇從 Amazon S3 儲存貯體匯入的檔案格式。

      3. 選擇 Add email addresses (新增電子郵件地址),開始從檔案匯入地址 - Bulk actions (大量動作) 索引標籤下會顯示表格。

    2. Import from file (從檔案匯入) - 如果您有本機來源檔案要上傳到新的或現有的 Amazon S3 儲存貯體

      1. Import source file (匯入來源檔案) 中,選取 Choose file (選擇檔案)。

      2. 在CSV檔案瀏覽器中選取JSON或檔案,然後選擇 [開啟]-您會在 [選檔案] 按鈕下看到檔案的名稱、大小和日期。

      3. 展開 Amazon S3 bucket (Amazon S3 儲存貯體),並選取 S3 儲存貯體。

        1. 若要將檔案上傳至新儲存貯體,請選擇 Create S3 bucket (建立 S3 儲存貯體),在 Bucket name (儲存貯體名稱) 欄位中輸入名稱,然後選擇 Create bucket (建立儲存貯體)。

      4. 選擇 Add email addresses (新增電子郵件地址),開始從檔案匯入地址 - Bulk actions (大量動作) 索引標籤下會顯示表格。

  5. 無論您使用何種匯入方法,Bulk actions (大量動作) 中都會列出您的任務 ID,以及匯入類型、狀態和日期 - 若要檢視任務詳細資訊,請選取任務 ID。

  6. 選取 Suppression list (禁止名單) 索引標籤,所有成功匯入的電子郵件地址及其禁止原因和新增日期都會顯示 - 以下是可用的選項:

    1. 選取電子郵件地址,或選取其對應的核取方塊,然後選擇 View report (檢視報告) 以檢視其詳細資訊 (如果這是因為退信或投訴而自動新增至禁止名單的地址,則會顯示成因意見回饋事件的相關資訊,包括產生觸發事件的電子郵件訊息的詳細資訊)。

    2. 根據您要從帳戶禁止名單中移除的一或多個電子郵件地址選取對應的核取方塊,然後選擇移除

查看 Amazon SES 帳戶級別禁止列表中的地址列表

您可以使用 v2 中的ListSuppressedDestinations作業,檢視帳戶帳戶層級隱藏清單上所有電子郵件地址的清單。SES API

注意

下列程序假設您已安裝 AWS CLI。若要取得有關安裝和配置的更多資訊 AWS CLI,請參閱《AWS Command Line Interface 使用者指南》

若要檢視您的帳戶層級禁止名單上所有電子郵件地址的清單
  • 在命令列中輸入以下命令:

    aws sesv2 list-suppressed-destinations

上述命令會傳回您的帳戶之帳戶層級禁止名單中的所有電子郵件地址。輸出看起來會與以下範例相似:

{ "SuppressedDestinationSummaries": [ { "EmailAddress": "recipient2@example.com", "Reason": "COMPLAINT", "LastUpdateTime": "2020-04-10T21:03:05Z" }, { "EmailAddress": "recipient0@example.com", "Reason": "COMPLAINT", "LastUpdateTime": "2020-04-10T21:04:26Z" }, { "EmailAddress": "recipient1@example.com", "Reason": "BOUNCE", "LastUpdateTime": "2020-04-10T22:07:59Z" } ] }
  • — 如果您的輸出包含含有字串值的 NextToken "" 欄位,則表示您帳戶的隱藏清單上還有其他電子郵件地址。若要檢視其他禁止的地址,請發出另一個請求至 ListSuppressedDestinations,並將傳回的字串值傳遞到 --next-token 參數,如下所示:

    aws sesv2 list-suppressed-destinations --next-token string

    在前面的命令中,替換 string 與返回的 NextToken 值。

    如需詳細資訊,請參閱如何從帳戶層級禁止清單列出超過 1000 個電子郵件地址

您可以使用 StartDate 選項,只顯示特定日期之後新增至清單的電子郵件地址。

若要檢視特定日期之後新增至您的帳戶層級禁止名單的地址清單
  • 在命令列中輸入以下命令:

    aws sesv2 list-suppressed-destinations --start-date 1604394130

    在前面的命令中,替換 1604394130 與開始日期的 Unix 時間戳。

您也可以使用 EndDate 選項,只顯示特定日期之前新增至清單的電子郵件地址。

若要檢視特定日期之前新增至您的帳戶層級禁止名單的地址清單
  • 在命令列中輸入以下命令:

    aws sesv2 list-suppressed-destinations --end-date 1611126000

    在前面的命令中,替換 1611126000 與結束日期的 Unix 時間戳。

在 Linux、macOS 或 Unix 命令列中,您也可以使用內建 grep 公用程式來搜尋特定地址或網域。

若要搜尋特定地址的帳戶層級禁止名單
  • 在命令列中輸入以下命令:

    aws sesv2 list-suppressed-destinations | grep -A2 'example.com'

    在前面的命令中,替換 example.com 包含您要搜尋的文字字串 (例如地址或網域)。

若要使用主控台檢視帳戶層級隱藏清單中所有電子郵件地址的SES清單:
  1. 登錄 AWS Management Console 並在打開 Amazon SES 控制台https://console.aws.amazon.com/ses/

  2. 在導覽窗格中的 Configuration (組態) 下,選擇 Suppression list (禁止名單)。

  3. Suppression list (禁止名單) 窗格中,系統會顯示帳戶層級禁止名單中的所有電子郵件地址,及其禁止原因和新增日期 - 以下是可用的選項:

    1. 選取電子郵件地址,或選取其對應的核取方塊,然後選擇 View report (檢視報告) 以檢視其詳細資訊 (如果這是因為退信或投訴而自動新增至禁止名單的地址,則會顯示成因意見回饋事件的相關資訊,包括產生觸發事件的電子郵件訊息的詳細資訊)。

    2. 您可以選擇齒輪圖示來自訂禁止名單表格 - 系統提供的模式可讓您在其中自訂頁面大小、換行和要檢視的各欄 - 完成選取之後,請選擇 Confirm (確認)。禁止名單表格會反映您的檢視選擇。

從您的 Amazon SES 帳戶級禁止列表中刪除單個電子郵件地址

如果地址在您的帳戶的禁止列表中,但您知道該地址不應在列表中,則可以使用 SES API v2 中的DeleteSuppressedDestination操作將其刪除。

注意

下列程序假設您已安裝 AWS CLI。若要取得有關安裝和配置的更多資訊 AWS CLI,請參閱《AWS Command Line Interface 使用者指南》

使用 AWS CLI從您的帳戶層級禁止名單中移除個別地址
  • 在命令列中輸入以下命令:

    Linux, macOS, or Unix
    aws sesv2 delete-suppressed-destination \ --email-address recipient@example.com
    Windows
    aws sesv2 delete-suppressed-destination ` --email-address recipient@example.com

    在前面的例子中,替換 recipient@example.com 使用您要從帳戶級別禁止列表中刪除的電子郵件地址。

若要使用主控台從帳戶層級隱藏清單中移除個別地址:SES
  1. 登錄 AWS Management Console 並在打開 Amazon SES 控制台https://console.aws.amazon.com/ses/

  2. 在導覽窗格中的 Configuration (組態) 下,選擇 Suppression list (禁止名單)。

  3. 移除個別電子郵件地址,方法是 (a) 表格選取或 (b) 輸入項目:

    1. 從表格選取:在 Suppression list (禁止名單) 表格中,選取一或多個電子郵件地址對應的核取方塊,然後選擇 Remove (移除)。

    2. 在欄位中輸入

      1. Suppression list (禁止名單) 表格中,選擇 Remove email address (移除電子郵件地址)。

      2. Email address (電子郵件地址) 欄位中輸入電子郵件地址 - 如果您需要輸入更多地址,請選擇 Enter another address (輸入其他地址) 並對每個額外的電子郵件地址重複執行以上動作。

      3. 輸入地址後,請檢閱輸入的準確性。如果您決定任何輸入項不應成為此提交的一部分,請選擇其 Remove (移除) 按鈕。

      4. 選擇儲存變更,將從帳戶層級禁止名單中移除輸入的電子郵件地址。

從 Amazon SES 帳戶級別禁止列表中批量刪除電子郵件地址

您可以先將連絡人清單上傳至 Amazon S3 物件,然後使用 SES API v2 中的CreateImportJob操作,以大量移除地址。

注意
  • 您可以從帳戶層級禁止清單中移除的地址數量沒有限制,但是每API次呼叫 Amazon S3 物件中的大量刪除限制為 10,000 個地址。

  • 如果您的資料來源是 S3 儲存貯體,它必須存在於您要匯入的相同區域中。

若要從帳戶層級禁止名單中移除大量電子郵件地址,請完成以下步驟。

  • 以或格式將您的通訊清單上傳到 Amazon S3 CSV 物JSON件。

    CSV刪除地址的格式示例:

    recipient3@example.com

    僅支持換行符分隔的JSON文件。在此格式中,每一行都是包含個別位址定義的完整JSON物件。

    JSON添加地址的格式示例:

    {"emailAddress":"recipient3@example.com"}

    在上述範例中,取代 recipient3@example.com 包含您要從帳戶級別禁止列表中刪除的電子郵件地址。

  • SES授予讀取 Amazon S3 物件的權限。

    套用至 Amazon S3 儲存貯體時,下列政策會SES授予讀取該儲存貯體的權限。如需將政策附加至 Amazon S3 儲存貯體的詳細資訊,請參閱《Amazon Simple Storage Service 使用者指南》中的使用儲存貯體政策和使用者政策

    { "Version": "2012-10-17", "Statement": [ { "Sid": "AllowSESGet", "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "s3:GetObject", "Resource": "arn:aws:s3:::BUCKET-NAME/OBJECT-NAME", "Condition": { "StringEquals": { "aws:Referer": "AWSACCOUNTID" } } } ] }
  • SES授予使用 AWS KMS 金鑰的權限。

    如果 Amazon S3 物件使用 AWS KMS 金鑰加密,您需要授予 Amazon 使用 AWS KMS 金鑰的SES權限。SES只能從客戶管理的金鑰取得權限,而不是預設KMS金鑰。您必須在金鑰政策中新增陳述式,以SES授予使用客戶管理金鑰的權限。

    將以下政策聲明粘貼到密鑰策略中,以SES允許使用客戶託管的密鑰。

    { "Sid": "AllowSESToDecrypt", "Effect": "Allow", "Principal": { "Service":"ses.amazonaws.com" }, "Action": [ "kms:Decrypt", ], "Resource": "*" }
  • 使用 SES API v2 中的CreateImportJob操作。

注意

下列範例假設您已安裝 AWS CLI。若要取得有關安裝和配置的更多資訊 AWS CLI,請參閱《AWS Command Line Interface 使用者指南》

在命令列輸入下列命令。Replace (取代) s3bucket 與 Amazon S3 存儲桶的名稱和 s3object 與 Amazon S3 對象的名稱。

aws sesv2 create-import-job --import-destination SuppressionListDestination={SuppressionListImportAction=DELETE} --import-data-source S3Url="s3://s3bucket/s3object",DataFormat=CSV
若要使用主控台從帳戶層級隱藏清單中大量移除電子郵件地址:SES
  1. 登錄 AWS Management Console 並在打開 Amazon SES 控制台https://console.aws.amazon.com/ses/

  2. 在導覽窗格中的 Configuration (組態) 下,選擇 Suppression list (禁止名單)。

  3. 禁止名單表格中,展開大量動作按鈕,然後選取大量移除電子郵件地址

  4. Bulk action specifications (大量動作規格) 中,選取 (a) Choose file from S3 bucket (從 S3 儲存貯體選擇檔案) 或 (b) Import from file (從檔案匯入) - 各種匯入方法的程序如下:

    1. 從 S3 儲存貯體選擇檔案 - 如果您的來源檔案已儲存在 Amazon S3 儲存貯體中

      1. 如果您知道要使用URI的 Amazon S3 儲存貯體,請在 Amazon S3 URI 欄位中輸入該儲存貯體;否則,請選擇瀏覽 S3

        1. Buckets (儲存貯體) 中,選取 S3 儲存貯體的名稱。

        2. Objects (物件) 中,選取檔案的名稱,然後選取 Choose (選擇) - 您將會回到 Bulk action specifications (大量動作規格)。

        3. (選用 ) 如果您想要前往 Amazon S3 主控台查看有關 S3 物件的詳細資訊,請選擇 View (檢視)。

      2. File format (檔案格式) 中,選取您選擇從 Amazon S3 儲存貯體匯入的檔案格式。

      3. 選擇 Remove email addresses (移除電子郵件地址),開始從檔案匯入地址 - Bulk actions (大量動作) 索引標籤下會顯示表格。

    2. Import from file (從檔案匯入) - 如果您有本機來源檔案要上傳到新的或現有的 Amazon S3 儲存貯體

      1. Import source file (匯入來源檔案) 中,選取 Choose file (選擇檔案)。

      2. 在CSV檔案瀏覽器中選取JSON或檔案,然後選擇 [開啟]-您會在 [選檔案] 按鈕下看到檔案的名稱、大小和日期。

      3. 展開 Amazon S3 bucket (Amazon S3 儲存貯體),並選取 S3 儲存貯體。

        1. 若要將檔案上傳至新儲存貯體,請選擇 Create S3 bucket (建立 S3 儲存貯體),在 Bucket name (儲存貯體名稱) 欄位中輸入名稱,然後選擇 Create bucket (建立儲存貯體)。

      4. 選擇 Remove email addresses (移除電子郵件地址),開始從檔案匯入地址 - Bulk actions (大量動作) 索引標籤下會顯示表格。

  5. 無論您使用何種匯入方法,Bulk actions (大量動作) 中都會列出您的任務 ID,以及匯入類型、狀態和日期 - 若要檢視任務詳細資訊,請選取任務 ID。

  6. 選取 Suppression list (禁止名單) 索引標籤,所有已從禁止名單中移除且成功匯入的電子郵件地址都不會再顯示。

檢視帳戶的匯入任務清單

您可以使用 Amazon SES API v2 中的ListImportJobs操作,檢視帳戶帳戶層級禁止清單中所有電子郵件地址的清單。

注意

下列程序假設您已安裝 AWS CLI。若要取得有關安裝和配置的更多資訊 AWS CLI,請參閱《AWS Command Line Interface 使用者指南》

檢視帳戶的所有匯入任務的清單
  • 在命令列中輸入以下命令:

    aws sesv2 list-import-jobs

上述命令會傳回帳戶的所有匯入任務。輸出看起來會與以下範例相似:

{ "ImportJobs": [ { "CreatedTimestamp": 2020-07-31T06:06:55Z", "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "PUT" } }, "JobStatus": "COMPLETED", "JobId": "755380d7-fbdb-4ed2-a9a3-06866220f5b5" }, { "CreatedTimestamp": "2020-07-30T18:45:32Z", "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "DELETE" } }, "JobStatus": "COMPLETED", "JobId": "076683bd-a7ee-4a40-9754-4ad1161ba8b6" }, { "CreatedTimestamp": "2020-08-05T16:45:18Z", "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "PUT" } }, "JobStatus": "COMPLETED", "JobId": "6e261869-bd30-4b33-b1f2-9e035a83a395" } ] }
若要使用SES主控台檢視帳戶的所有匯入工作清單:
  1. 登錄 AWS Management Console 並在打開 Amazon SES 控制台https://console.aws.amazon.com/ses/

  2. 在導覽窗格中的 Configuration (組態) 下,選擇 Suppression list (禁止名單)。

  3. Suppression list (禁止名單) 窗格中,選取 Bulk actions (大量動作) 索引標籤。

  4. Bulk actions (大量動作) 表格中會列出所有匯入任務,以及匯入類型、狀態和日期。

  5. 若要檢視任務詳細資訊,請選取任務 ID,下列窗格隨即顯示:

    1. Bulk action status (大量動作狀態):顯示任務的整體狀態、完成的時間和日期、匯入的記錄數目,以及無法順利匯入的完整記錄計數。

    2. 大量動作詳細資訊:顯示任務 ID、是否用於新增或移除地址、檔案格式是否為JSON或CSV、儲存大量檔案的 Amazon S3 儲存貯體,以及建立批次處理動作的時間和日期。URI

取得帳戶匯入任務的相關資訊

您可以使用 Amazon SES API v2 中的GetImportJob操作,取得帳戶匯入任務的相關資訊。

注意

下列程序假設您已安裝 AWS CLI。若要取得有關安裝和配置的更多資訊 AWS CLI,請參閱《AWS Command Line Interface 使用者指南》

取得帳戶匯入任務的相關資訊
  • 在命令列中輸入以下命令:

    aws sesv2 get-import-job --job-id JobId

上述命令會傳回帳戶匯入任務的相關資訊。輸出看起來會與以下範例相似:

{ "ImportDataSource": { "S3Url": "s3://bucket/object", "DataFormat": "CSV" }, "ProcessedRecordsCount": 2, "FailureInfo": { "FailedRecordsS3Url": "s3presignedurl" }, "JobStatus": "COMPLETED", "JobId": "jobid", "CreatedTimestamp": "2020-08-12T17:05:15Z", "FailedRecordsCount": 1, "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "PUT" } }, "CompletedTimestamp": "2020-08-12T17:06:42Z" }
使用主控台取得帳戶匯入工作的相關資SES訊:
  1. 登錄 AWS Management Console 並在打開 Amazon SES 控制台https://console.aws.amazon.com/ses/

  2. 在導覽窗格中的 Configuration (組態) 下,選擇 Suppression list (禁止名單)。

  3. Suppression list (禁止名單) 窗格中,選取 Bulk actions (大量動作) 索引標籤。

  4. Bulk actions (大量動作) 表格中會列出所有匯入任務,以及匯入類型、狀態和日期。

  5. 若要檢視任務詳細資訊,請選取任務 ID,下列窗格隨即顯示:

    1. Bulk action status (大量動作狀態):顯示任務的整體狀態、完成的時間和日期、匯入的記錄數目,以及無法順利匯入的完整記錄計數。

    2. 大量動作詳細資訊:顯示任務 ID、是否用於新增或移除地址、檔案格式是否為JSON或CSV、儲存大量檔案的 Amazon S3 儲存貯體,以及建立批次處理動作的時間和日期。URI

禁用 Amazon SES 帳戶級別禁止列表

您可以使用 SES API v2 中的PutAccountSuppressionAttributes作業,藉由移除屬性中的值,有效地停用帳戶層級隱藏清單。suppressed-reasons

注意

下列程序假設您已安裝 AWS CLI。若要取得有關安裝和配置的更多資訊 AWS CLI,請參閱《AWS Command Line Interface 使用者指南》

若要使用停用帳戶層級隱藏清單 AWS CLI
  • 在命令列中輸入以下命令:

    aws sesv2 put-account-suppression-attributes --suppressed-reasons
若要使用主控台停用帳戶層級隱藏清單:SES
  1. 登錄 AWS Management Console 並在打開 Amazon SES 控制台https://console.aws.amazon.com/ses/

  2. 在導覽窗格中的 Configuration (組態) 下,選擇 Suppression list (禁止名單)。

  3. Account-level settings (帳戶層級設定) 窗格中,選擇 Edit (編輯)。

  4. Suppression list (禁止名單) 中,取消勾選 Enabled (已啟用) 方塊。

  5. 選擇 Save changes (儲存變更)。