本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 地址清單
地址清單是一項郵件管理員功能，可讓您建立和管理可用於流量政策和規則集的電子郵件地址和網域清單，以根據訊息的收件人或寄件者是否屬於特定清單來處理傳入郵件。地址清單可更精細地控制電子郵件流程，並協助簡化複雜電子郵件路由案例的管理。
## 什麼是地址清單？
地址清單是電子郵件地址和網域的容器，可用來篩選和處理電子郵件訊息。它們提供便捷的方式來分組相關地址，並共同套用路由規則和流量政策。
地址清單的主要使用案例包括：
+ 拒絕封鎖已知垃圾郵件寄件者或網域的清單
+ 允許清單，以確保從信任的寄件者交付
+ 收件人驗證以拒絕電子郵件給不存在的收件人
+ 根據收件人角色套用不同規則的角色型路由
+ 針對特定使用者群組強制執行政策的群組型政策
## 地址清單的運作方式
SES 中的地址清單可讓您建立和維護電子郵件地址和網域的集合，以簡化電子郵件管理。建立後，這些清單會透過流量政策和規則整合到您的電子郵件工作流程中。
當 SES 處理電子郵件時，它會檢查相關的地址清單，以判斷寄件者或收件人是否為成員。根據此成員資格和您設定的政策和規則，SES 接著會採取適當的動作，例如轉接、篩選或拒絕電子郵件。此程序可有效且精細地控制您的電子郵件流量。
## 設定地址清單
**Topics**
+ [建立和填入地址清單](#creating-address-lists)
+ [管理地址清單](#managing-address-lists)
### 建立和填入地址清單
在 主控台中建立地址清單的一部分是將其填入一或多個地址。您可以使用 Mail Manager APIs 建立空白地址清單，並在稍後填入。本節將說明如何同時使用主控台程序和 AWS CLI 範例。
**若要建立和填入地址清單：**
1. 在 [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/)：// 開啟 SES 主控台。
1. 在郵件管理員下的導覽窗格中，選擇**地址清單**。
1. 選擇**建立地址清單**，然後在**地址清單名稱欄位中輸入名稱**。
1. 選取**手動項目**或**大量上傳**，並遵循各自的步驟：
1. **針對手動輸入** – 在主控台中輸入一或多個電子郵件地址或網域。
如果您使用星號 (`*`) 萬用字元，則適用下列格式：
1. 地址中只`*`允許一個地址：
+ 當項目為電子郵件地址時， `*` 應該在 @ 之前或之後。
+ 當 `*` 位於本機部分時，本機部分可以是 0 到 19 個字元，但 除外`*`。
+ 當 `*` 在網域中時，子網域層級可以是 2 到 9，但 除外`*`。
1. 有效萬用字元格式的範例：
+ *\$1.domain1.com 到 \$1.domain8.domain7...domain1.com*
+ *\$1@domain.com 至 1234567890123456789\$1@domain.com*
+ *local@\$1.domain1.com 到 local@\$1.domain8.domain7...domain1.com*
1. **針對大量上傳** – 選取**選擇檔案**，然後從包含要上傳地址的電腦中選擇 CSV 或 JSON 檔案。
針對每個檔案類型使用範例中顯示的格式：
1. CSV 檔案範例 （請注意，標頭 `address`是必要的。)：
```
address
user1@domain.com
user2@*.domain.com
*@domain.com
```
1. JSON 檔案範例：
```
{
"items": [
{
"address": "user1@domain.com"
},
{
"address": "user2@*.domain.com"
},
{
"address": "*@domain.com"
}
]
}
```
1. 完成新增地址或選取大量檔案後，請選擇**建立地址清單**。
使用 AWS CLI：
**建立地址清單**
```
aws mailmanager create-address-list --address-list-name "MyDenyList"
```
**填入地址清單：**
+ **單一上傳**
```
aws mailmanager register-member-to-address-list \
--address-list-id al-123456789abc \
--address "user@example.com"
```
+ **大量上傳**
對於大量上傳，您必須先建立指定 CSV 或 JSON 格式的匯入任務：
```
aws mailmanager create-address-list-import-job \
--address-list-id "al-123456789abc" \
--name "MyImportJob" \
--import-data-format ImportDataType=CSV
```
這會傳回任務 ID 和預先簽章的 URL。使用此預先簽章的 URL 將您的 CSV 或 JSON 檔案上傳至 S3 儲存貯體，如使用 curl 命令的下列範例所示：
```
curl -X PUT -T "/path/to/file" "pre-signed URL"
```
上傳後，使用上一個命令中傳回的任務 ID 啟動匯入任務：
```
aws mailmanager start-address-list-import-job --job-id "job-123456789"
```
### 管理地址清單
您可以視需要更新、檢視和刪除地址清單。
**Topics**
+ [更新地址清單](#updating-address-lists)
+ [檢視地址清單詳細資訊](#viewing-address-lists)
+ [刪除地址清單](#deleting-address-lists)
#### 更新地址清單
您可以新增或移除地址來更新地址清單，也可以選擇新增或移除標籤。
**若要更新地址清單：**
1. 在**地址清單**頁面上，選取您要編輯的地址清單名稱。
1. 若要新增地址，請選擇**新增電子郵件地址**，並繼續手動輸入或大量上傳方法，如 中所述[建立和填入地址清單](#creating-address-lists)。
1. 若要移除地址，請選取您要移除的每個地址旁的核取方塊，然後**移除電子郵件地址**並確認刪除。
1. （選用） 選擇**管理****標籤**，將標籤新增至或移除您的地址清單。
使用 AWS CLI：
**Add**
```
aws mailmanager register-member-to-address-list \
--address-list-id al-123456789abc \
--address "user@example.com"
```
**移除**
```
aws mailmanager deregister-member-from-address-list \
--address-list-id al-123456789abc \
--address "user@example.com"
```
#### 檢視地址清單詳細資訊
若要檢視地址清單詳細資訊：
+ 在**地址清單**頁面上，選取地址清單的名稱以檢視其詳細資訊。
使用 AWS CLI：
```
aws mailmanager list-members-of-address-list --address-list-id al-123456789abc
```
#### 刪除地址清單
若要刪除地址清單：
1. 在**地址清單**頁面上，選取您要刪除的地址清單旁邊的選項按鈕，接著選取**刪除**。
1. 輸入*確認*後接刪除，確認**刪除**清單。
使用 AWS CLI：
```
aws mailmanager delete-address-list --address-list-id al-123456789abc
```
## 在流量政策和規則集中使用地址清單
地址清單可用於流量政策陳述式和規則條件，以根據允許控制電子郵件流程的清單成員資格來處理電子郵件。以下各節提供在每個流量政策和規則集中使用的地址清單範例。
**Topics**
+ [流量政策範例](#traffic-policy-example)
+ [規則集範例](#rule-set-example)
### 在流量政策陳述式中使用地址清單
當您建置流量政策陳述式的條件，以允許或拒絕傳入端點的電子郵件時，可以選擇地址清單。
下列主控台程序及其 AWS CLI 對等項目顯示建立政策陳述式的範例，當收件人位於指定的地址清單中時，允許訊息進入您的輸入端點。
**若要在流量政策陳述式中使用地址清單：**
1. 建立新的流量政策或編輯現有的流量政策，如 中所述 [建立流量政策和政策陳述式 （主控台）](eb-filters.md#eb-filters-create-console)
1. 在**政策陳述**式容器中，選擇**允許**在符合陳述式的條件時採取動作。
1. 建置陳述式的條件，如下所示：
+ 選取**通訊協定**欄位的**收件人地址**。
+ 選取運算**子**欄位**的地址清單中的 **。
+ 選取**值**欄位的地址清單名稱。
1. 雖然這只是一個範例，但您可以新增更多政策條件，這些條件可以根據具有任何地址清單的各種運算子。
使用 AWS CLI：
```
aws mailmanager create-traffic-policy \
--default-action ALLOW \
--traffic-policy-name "testpolicy" \
--policy-statements '[{
"Action": "ALLOW",
"Conditions": [{
"BooleanExpression": {
"Evaluate": {
"IsInAddressList": {
"Attribute": "RECIPIENT",
"AddressLists": [
"arn:aws:ses:eu-west-3:123456789012:mailmanager-address-list/al-123456789abc"
]
}
},
"Operator": "IS_TRUE"
}
}]
}]'
```
### 在規則中使用地址清單
當您建置其中一個規則集中使用的規則條件以觸發規則的動作時，可以選擇地址清單。
下列主控台程序及其 AWS CLI 對等項目顯示建立規則的範例，該規則會在收件人位於指定的地址清單中時呼叫捨棄動作。
**若要在規則條件中使用地址清單：**
1. 如 中所述建立新的規則或編輯現有的規則 [建立規則集和規則 （主控台）](eb-rules.md#eb-rules-create-console)
1. 在**規則條件**容器中，如下所示建置規則的條件。
+ 選取**選取屬性**欄位的**收件人地址**。
+ 選取**選取運算子**欄位**的地址清單中的 **。
+ 選取**值**欄位的地址清單名稱。
1. 在**動作**容器中，選擇**新增動作**，然後選取**捨棄動作**。
1. 雖然這只是一個範例，但您可以新增更多規則條件，這些條件可以根據具有任何地址清單的各種運算子，以採取各種動作。
使用 AWS CLI：
```
aws mailmanager create-rule-set \
--rule-set-name "testruleset2" \
--rules '[{
"Name": "addresslist",
"Conditions": [{
"BooleanExpression": {
"Evaluate": {
"IsInAddressList": {
"Attribute": "RECIPIENT",
"AddressLists": [
"arn:aws:ses:us-east-1:123456789012:mailmanager-address-list/al-123456789abc"
]
}
},
"Operator": "IS_TRUE"
}
}],
"Actions": [{
"Drop": {}
}]
}]'
```
## 最佳實務和考量
+ 請注意清單大小 - 非常大的清單可能會影響效能。
+ 地址清單是帳戶特定的，只能在同一個 AWS 帳戶中使用。
+ 目前不支援巢狀地址清單。
+ 每個區域最多支援 100 個地址清單。
+ 每個地址清單最多支援 100，000 個地址。