先決條件啟用租戶層級禁止設定新租用戶的禁止使用組態集覆寫停用租戶層級禁止檢視目前的禁止組態疑難排解相關資源

設定租戶層級禁止

設定租戶層級禁止設定，以控制 Amazon Simple Email Service (Amazon SES) 如何處理個別租戶的退信和投訴。根據預設，租戶會使用您的帳戶層級禁止名單。當您啟用租用戶層級禁止時，SES 會維護每個租用戶的個別禁止名單。這可讓您精細控制電子郵件可交付性。

本主題提供使用啟用、修改、停用和檢視租用戶層級禁止設定的程序 AWS CLI。

重要

停用租戶層級禁止不會從租戶禁止名單中刪除現有項目。如果您稍後重新啟用租用戶層級禁止，這些項目仍會處於作用中狀態。

先決條件

設定租戶層級禁止之前，請確定您符合下列要求：

您的 SES 帳戶中已啟用多租用戶。
您的帳戶中至少有一個租用戶，或者您計劃在此程序中建立一個租用戶。
AWS CLI 第 2 版已安裝並設定了適當的許可。如需詳細資訊，請參閱「AWS Command Line Interface 使用者指南」。
您熟悉帳戶層級禁止概念。如需詳細資訊，請參閱使用 Amazon SES 帳戶層次禁止名單。

啟用現有租用戶的租用戶層級禁止

使用 PutTenantSuppressionAttributes API 操作來啟用現有租用戶的租用戶層級禁止。此操作是等冪的，因此您可以使用相同的參數多次呼叫它，而不會產生副作用。

啟用租戶層級禁止

在命令列，執行下列put-tenant-suppression-attributes命令來啟用退信和投訴的租戶層級抑制：

將 MyTenant 取代為您的租用戶名稱。

確認命令未傳回任何輸出。成功的請求會傳回沒有內文的 HTTP 200 回應。

執行下列命令來確認組態：


aws sesv2 get-tenant --tenant-name MyTenant

租戶現在會針對退信和投訴使用自己的禁止名單。

您也可以為單一原因類型設定抑制。下列範例示範如何僅針對退信或投訴啟用抑制。

下列命令只會抑制退信：

下列命令只會抑制投訴：

注意

您必須--suppressed-reasons一併提供 --suppression-scope和。在沒有另一個的情況下提供一個會傳回 InvalidParameterValueException。

建立新租用戶時設定禁止

使用 CreateTenant API 操作搭配 SuppressionAttributes 參數，從一開始就建立已啟用租用戶層級禁止的租用戶。

建立具有租用戶層級禁止的租用戶

在命令列中，執行下列create-tenant命令：

使用新租用戶的名稱取代 MyNewTenant。

確認回應包含租戶 ID：
```
{
    "TenantId": "tn-abc123def456"
}
```

租用戶的建立會同時啟用退信和投訴的租用戶層級抑制。

注意

如果您省略 --suppression-attributes，租戶會預設為ACCOUNT範圍，並使用帳戶層級禁止名單。

使用組態集覆寫租戶禁止

您可以將 SuppressionScope新增至組態集的，以覆寫租戶的禁止設定SuppressionOptions。當您使用此組態集傳送電子郵件時，組態集的禁止設定優先於租戶的設定。您只能覆寫範圍、僅限原因，或同時覆寫兩者。

建立具有租用戶範圍覆寫的組態設定

在命令列中，執行下列create-configuration-set命令：

以組態my-config-setset。

確認命令未傳回任何輸出。成功的請求會傳回 HTTP 200 回應。

使用禁止選項更新現有的組態設定

在命令列中，執行下列put-configuration-set-suppression-options命令：

以組態集的名稱取代 my-config-setset。

確認命令未傳回任何輸出。成功的請求會傳回 HTTP 200 回應。

停用租戶層級禁止

若要將租戶傳回帳戶層級禁止，您可以將範圍設定為 ACCOUNT 或清除所有禁止設定。

將租戶設定為帳戶層級禁止

在命令列中，執行下列命令，將範圍明確設定為 ACCOUNT：

將 MyTenant 取代為您的租用戶名稱。

確認命令未傳回任何輸出。

清除所有禁止設定

在命令列中，執行下列命令，而不指定範圍或原因：
```
aws sesv2 put-tenant-suppression-attributes --tenant-name MyTenant
```
將 MyTenant 取代為您的租用戶名稱。
確認命令未傳回任何輸出。

注意

當您省略 --suppression-scope和時--suppressed-reasons，SES 會清除租戶的禁止設定。租用戶會回到帳戶層級的禁止行為。

重要

停用租戶層級禁止不會從租戶禁止名單中刪除現有項目。如果您稍後重新啟用租用戶層級禁止，這些項目仍會處於作用中狀態。

檢視目前的禁止組態

使用 GetTenant API 操作來檢查租用戶目前的禁止設定。

檢視租戶的禁止組態

在命令列中，執行下列get-tenant命令：
```
aws sesv2 get-tenant --tenant-name MyTenant
```
將 MyTenant 取代為您的租用戶名稱。

檢閱回應。下列範例顯示已啟用租用戶層級禁止的租用戶：


{
    "Tenant": {
        "TenantName": "MyTenant",
        "TenantId": "tn-abc123def456",
        "TenantArn": "arn:aws:ses:us-east-1:123456789012:tenant/MyTenant/tn-abc123def456",
        "SendingStatus": "ENABLED",
        "CreatedTimestamp": 1705312800,
        "UpdateTimestamp": 1705762800,
        "SuppressionAttributes": {
            "SuppressionScope": "TENANT",
            "SuppressedReasons": ["BOUNCE", "COMPLAINT"]
        }
    }
}

下表說明 SuppressionAttributes 物件中的金鑰欄位。

欄位	說明
`SuppressionScope`	租用戶的禁止範圍。的值`TENANT`表示租戶使用自己的禁止名單。的值`ACCOUNT`表示租戶使用帳戶層級禁止名單。
`SuppressedReasons`	租用戶作用中的禁止原因。可能的值為 `BOUNCE`、 `COMPLAINT`或兩者。

如果回應中不存在或SuppressionAttributes為 null，則租戶會使用帳戶層級禁止。

疑難排解

以下是您在設定租用戶層級禁止時可能遇到的常見錯誤。

InvalidParameterValueException: SuppressedReasons cannot be null when SuppressionScope is provided

原因 – 您指定的--suppression-scope沒有 --suppressed-reasons。
修正 – 同時提供兩個參數，或省略這兩個參數以清除設定。

InvalidParameterValueException: SuppressionScope is required when SuppressedReasons are provided

原因 – 您指定的--suppressed-reasons沒有 --suppression-scope。
修正 – 同時提供兩個參數。

NotFoundException

原因 – 您指定的租戶名稱不存在。
修正 – 執行下列命令來驗證租用戶名稱：
```
aws sesv2 list-tenants
```

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

租戶層級禁止名單

管理租戶禁止項目