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

租用戶

本章說明如何使用 Amazon SES 租用戶管理來隔離、監控和管理 SES 帳戶中多個租用戶之間的電子郵件傳送。此功能可協助獨立軟體廠商 (ISVs)、企業和組織代表多個下游實體傳送電子郵件，維護個別的評價設定檔，並防止一個租用戶的問題影響其他人。

什麼是租戶管理？

租戶管理是一項功能，可讓您在 SES 帳戶中建立名為「租戶」的隔離容器。每個租戶可以有自己的電子郵件身分、組態集、範本和評價指標，確保電子郵件活動在不同的客戶或業務單位之間完全分開。

租戶管理解決了以下挑戰：一個客戶的不良電子郵件實務先前可能會暫停整個 SES 帳戶，影響所有其他客戶。透過租戶隔離，您可以獨立管理多個電子郵件串流，同時保持集中式監督和控制。

租用戶做為邏輯容器，將相關的 SES 資源分組在一起。當您代表特定租戶傳送電子郵件時，SES 會追蹤評價指標，並在租戶層級強制執行政策。此隔離可確保來自一個租用戶的高退信率或投訴率不會影響其他租用戶傳送的電子郵件可交付性。

租戶管理對下列項目特別有用：

租戶管理的運作方式

租戶評價管理的運作方式是為您的電子郵件傳送資源建立邏輯容器。您可以將特定資源指派給每個租戶，包括已驗證的身分 （網域和電子郵件地址）、組態集和範本。代表租用戶傳送電子郵件時，您可以在 API 呼叫或 SMTP 標頭中指定租用戶，SES 會驗證正在使用的資源是否與該租用戶正確關聯。

資源關聯

SES 帳戶中的資源可以透過兩種方式與租戶建立關聯：

當您將資源與租戶建立關聯時，該租戶會取得使用該資源傳送電子郵件的許可。對於每個傳送請求，SES 會驗證指定的租用戶是否具有在請求中使用身分、組態設定和範本的許可。如果資源未正確關聯，傳送請求會失敗。

評價監控和強制執行

SES 會持續監控每個租用戶的關鍵評價指標，包括退信率、投訴率 （包括信箱提供者意見反應迴路 (FBL) 系統） 和第三方意見反應訊號。當這些指標超過定義的閾值時，SES 會建立分類為：

根據這些調查結果，SES 可以透過您設定的評價政策自動暫停有問題的租戶。有三種強制執行層級可用：

當租戶指標觸發符合所選政策下強制執行閾值的評價調查結果時，系統會自動將租戶的傳送狀態更新為「已暫停」，而不會影響其他租戶的傳送功能。當租用戶暫停時，任何使用該租用戶傳送電子郵件的嘗試都會失敗，直到您檢閱問題並手動重新啟用傳送為止。此外，您可以視需要手動暫停租戶的傳送功能，並在準備好繼續傳送時將其解除暫停。

設定租戶

建立租用戶

使用 主控台：

使用 AWS CLI：

aws sesv2 create-tenant \
    --tenant-name "MyTenant" \
    --region us-east-1

將資源指派給租用戶

建立租用戶之後，您必須先指派至少一個已驗證的身分和一個組態集，租用戶才能傳送電子郵件。

使用 主控台：

使用 AWS CLI：

# Assign an identity to a tenant
aws sesv2 create-tenant-resource-association \
    --tenant-name "MyTenant" \
    --resource-arn "arn:aws:ses:us-east-1:123456789012:identity/example.com" \
    --region us-east-1

# Assign a configuration set to a tenant
aws sesv2 create-tenant-resource-association \
    --tenant-name "MyTenant" \
    --resource-arn "arn:aws:ses:us-east-1:123456789012:configuration-set/MyConfigSet" \
    --region us-east-1

設定評價政策

評價政策會根據評價指標自動暫停租戶的電子郵件傳送。當您建立租用戶時，SES 會自動指派標準評價政策。如果您想要變更為其他政策，請使用下列步驟。

使用 主控台：

使用 AWS CLI：

update-reputation-entity-policy \
    --reputation-entity-type "RESOURCE" \
    --reputation-entity-reference "arn:aws:ses:us-east-1:123456789012:tenant/tenantId" \
    --reputation-entity-policy "arn:aws:ses:us-east-1:aws:reputation-policy/standard"

向租戶傳送電子郵件

透過租用戶傳送電子郵件時，您必須在 API 呼叫或 SMTP 標頭中指定租用戶，並確保所有使用的資源都與該租用戶相關聯。

搭配租戶使用 SendEmail API

AWS CLI 範例：

aws sesv2 send-email \
  --tenant-name "MyTenant" \
  --from-email-address "sender@example.com" \
  --destination "ToAddresses=recipient@example.com" \
  --content "Simple={Subject={Data='Test Subject',Charset=utf-8},Body={Text={Data='Test email body',Charset=utf-8}}}" \
  --configuration-set-name "MyConfigSet"

AWS 適用於 Python 的 SDK 範例：

import boto3

client = boto3.client('sesv2')
response = client.send_email(
    FromEmailAddress='sender@example.com',
    Destination={
        'ToAddresses': ['recipient@example.com']
    },
    Content={
        'Simple': {
            'Subject': {
                'Data': 'Test email'
            },
            'Body': {
                'Text': {
                    'Data': 'This is a test email sent using a tenant.'
                }
            }
        }
    },
    ConfigurationSetName='MyConfigurationSet',
     TenantName='MyTenant'
)

搭配租戶使用 SMTP

使用 SMTP 透過租用戶傳送電子郵件時，請在電子郵件標頭中包含租用戶資訊：

X-SES-TENANT: MyTenant

此標頭告知 SES 哪些租用戶應該用於電子郵件傳送操作，允許 SES 套用適當的資源驗證和評價追蹤。

管理租戶狀態

檢視租戶狀態和指標

使用 主控台：

使用 AWS CLI：

# Get tenant details
aws sesv2 get-tenant --tenant-name "MyTenant"

暫停和取消暫停租用戶

您可以視需要手動暫停租戶的傳送功能，並在準備好繼續傳送時將其解除暫停。

使用 主控台：

使用 AWS CLI：

若要暫停租用戶：

# Pause a tenant
aws sesv2 update-reputation-entity-customer-managed-status \
  --reputation-entity-type RESOURCE 
  --reputation-entity-reference "arn:aws:ses:us-east-1:593442965613:tenant/tenantId"
  --sending-status DISABLED

若要取消暫停租用戶：

# Unpause a tenant
aws sesv2 update-reputation-entity-customer-managed-status \
  --reputation-entity-type RESOURCE 
  --reputation-entity-reference "arn:aws:ses:us-east-1:593442965613:tenant/tenantId"
  --sending-status ENABLED

使用評價調查結果

檢視評價調查結果

使用 主控台：

使用 AWS CLI：

aws sesv2 list-recommendations \
   --filter='{ "RESOURCE_ARN":"arn:aws:ses:us-east-1:012345678901:tenant/tenantId"}'

回應包含所有作用中問題清單的詳細資訊：

{
    "Recommendations": [
        {
            "ResourceArn": "arn:aws:ses:us-east-1:012345678901:tenant/{tenant-name}/{tenant-id}",
            "Type": "BOUNCE",
            "Description": "The bounce rate exceeded 15.0% based on a representative volume of 664 emails from July 11, 2025 at 14:41 (UTC) to July 11, 2025 at 16:26 (UTC).",
            "Status": "OPEN",
            "CreatedTimestamp": "2025-07-11T16:16:14.029000+00:00",
            "LastUpdatedTimestamp": "2025-07-11T16:37:14.145000+00:00",
            "Impact": "HIGH"
        }
    ]
}

了解評價調查結果

評價調查結果可讓您深入了解租戶的電子郵件傳送實務的潛在問題。每個調查結果包括：

常見的問題清單包括：

解決評價問題

當您收到評價調查結果時，請務必調查根本原因並立即採取修正動作：

監控與分析

設定 CloudWatch 指標

SES 會將租戶特定的指標發佈至 Amazon CloudWatch。下列指標適用於每個租用戶：

設定 EventBridge 通知

根據預設，SES 會在偵測到租用戶評價調查結果或租用戶狀態變更時，將事件傳送至 EventBridge 預設事件匯流排。

您可在預設事件匯流排上建立規則，以識別 EventBridge 要傳送至一個或多個指定目標的特定事件。

提供下列詳細資訊類型：

對於租戶傳送狀態變更：

對於評價調查結果：

評價調查結果的 EventBridge 規則模式範例：

{
  "detail-type": "Advisor Recommendation Status Open",
  "source": "aws.ses",
  "account": "012345678901",
  "time": "2023-11-15T17:00:59Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:ses:us-east-1:012345678901:tenant/{tenant-name}/{tenant-id}"
  ],
  "detail": { 
       "version": "1.0.0",
       "data": "The bounce rate exceeded 15.0% based on a representative volume of 197 emails from July 11, 2025 at 14:43 (UTC) to July 11, 2025 at 16:13 (UTC).",
       "metadata":{"impact":"HIGH","type":"BOUNCE"}
  
    }
}

傳送狀態變更的 EventBridge 規則模式範例：

{
        "detail-type": "Sending Status Disabled",
        "source": "aws.ses",
        "account": "012345678901",
        "time": "2025-07-24T12:44:28Z",
        "region": "us-east-1",
        "resources": [
            "arn:aws:ses:us-east-1:012345678901:tenant/{tenant-name}/{tenant-id}"
        ],
        "detail": {
            "version": "1.0.0",
            "data": {
                "origin": "CUSTOMER_MANAGED",
                "record": {
                    "status": "DISABLED",
                    "cause": "Status manually updated.",
                    "lastUpdatedTimestamp": [2025, 7, 24, 12, 44, 28, 995000000]
                }
            }
        }
    }

欄位描述：

您可以使用這些事件來監控租戶狀態變更，並自動化應用程式中的回應。例如，您可能想要在停用租用戶時觸發提醒，或追蹤租用戶運作狀態指標一段時間。

與 AWS 信任與安全的整合

當 AWS 信任與安全偵測到通常會導致帳戶層級強制執行的問題時，租戶系統會啟用更多目標回應。信任與安全可以僅暫停有問題的租用戶，同時允許合規租用戶繼續傳送，而不是暫停整個帳戶。

此租戶層級強制執行可降低評價問題的影響，並有助於維持其他電子郵件串流的業務持續性。

當 SES 由於影響租戶評價的高嚴重性問題而停用傳送，並且您的帳戶受到審核時，您將會收到通知。案例會在 AWS 支援中心為您開啟，讓您可以與信任與安全部門合作，以解決問題並還原受影響租用戶的傳送。

最佳實務

遵循這些最佳實務，以有效管理 Amazon SES 中的租戶評價：

限制

使用租戶管理時，請注意下列限制：

定價

根據電子郵件數量，每個租戶每月需支付額外費用。如需詳細的定價資訊，請參閱 SES 定價頁面。

搭配租戶指標使用 CloudWatch 時，提供每個租戶的標準 CloudWatch 指標，作為基本監控的一部分，無需額外費用。自訂儀表板、警示或詳細監控等其他 CloudWatch 功能可能會產生標準 CloudWatch 費用。