本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 AWS 最終使用者傳訊簡訊中設定 Amazon SNS 事件目的地
Amazon Simple Notification Service (Amazon SNS) 是一種 Web 服務，可讓應用程式、最終使用者和裝置即時傳送和接收通知。若要進一步了解 Amazon SNS，請參閱 [Amazon Simple Notification Service 開發人員指南](https://docs.aws.amazon.com/sns/latest/dg/)。
本節中的一些範例假設您已安裝並設定 AWS Command Line Interface。如需設定 的詳細資訊 AWS CLI，請參閱 [AWS Command Line Interface 使用者指南](https://docs.aws.amazon.com/cli/latest/userguide/)。
**Topics**
+ [Amazon SNS 存取政策](configuration-sets-sns-creating-role.md)
+ [建立 Amazon SNS 事件目的地](configuration-sets-sns-add.md)
+ [編輯 Amazon SNS 事件目的地](configuration-sets-sns-edit.md)
+ [刪除 Amazon SNS 事件目的地](configuration-sets-sns-delete.md)
# Amazon SNS 存取政策
Amazon SNS 主題的存取是由連接至 Amazon SNS 主題*的資源政策*所控制，這也稱為*存取政策*。如需 Amazon SNS *存取政策*的詳細資訊，請參閱《*Amazon SNS 開發人員指南*》中的[身分和存取管理](https://docs.aws.amazon.com/sns/latest/dg/security-iam.html)。
**注意**
如果您的 Amazon SNS 主題已啟用伺服器端加密， AWS Key Management Service 則 也會將政策新增至相關聯的[對稱加密客戶](#configuration-sets-sns-creating-role-encrypted)受管金鑰。
使用下列陳述式更新*存取政策*，以允許 AWS 最終使用者傳訊簡訊發佈至 Amazon SNS 主題。
+ 將 *111122223333* 取代為您 AWS 帳戶的唯一 ID。
+ 將 *TopicName* 取代為 Amazon SNS 主題的名稱。
+ 將*區域*取代 AWS 區域 為包含 Amazon SNS 主題和組態設定的 。
+ 將 *ConfigSetName* 取代為組態集的名稱。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sns:Publish",
"Resource": "arn:aws:sns:us-east-1:111122223333:TopicName",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "accountId"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
}
}
}
]
}
```
------
## 加密 Amazon SNS 主題的存取政策
如果您的 Amazon SNS 主題已啟用伺服器端加密 AWS Key Management Service，請將下列政策新增至相關聯的對稱加密客戶受管金鑰。您必須將政策新增至客戶受管金鑰，因為您無法修改 Amazon SNS 的 AWS 受管金鑰。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "example-ID",
"Statement": [
{
"Sid": "example-statement-ID",
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": "*"
}
]
}
```
------
# 在 AWS 最終使用者傳訊簡訊中建立 Amazon SNS 事件目的地
您必須先建立 Amazon SNS 主題，才能建立 Amazon SNS 事件目的地。如需建立 Amazon SNS 主題的詳細資訊，請參閱《*Amazon Simple Notification Service 開發人員指南*》中的[建立主題](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html)。
您也必須已設定組態設定，以將事件目的地與 建立關聯，請參閱 [AWS 最終使用者傳訊簡訊中的組態設定](configuration-sets.md)。
------
#### [ Create an Amazon SNS event destination (Console) ]
若要使用 AWS 最終使用者簡訊 SMS 主控台建立 Amazon SNS 事件目的地，請遵循下列步驟：
1. 開啟位於 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 的 AWS 終端使用者簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**組態集**。
1. 在**組態設定**頁面上，選擇要新增事件目的地的組態設定。
1. 在**組態設定詳細資訊**頁面上，選擇**新增目的地事件**。
1. 在**事件詳細資訊**區段下，輸入名稱。
1. 從**目的地類型**下拉式清單中選擇 Amazon SNS。
1. **新的 Amazon SNS 主題** – 選擇此選項，讓 AWS 最終使用者傳訊簡訊在您的帳戶中建立主題。系統將自動建立主題，並授予所有必要的許可。如需 Amazon SNS 主題的詳細資訊，請參閱《Amazon [Simple Notification Service ](https://docs.aws.amazon.com/sns/latest/dg/)[開發人員指南》中的設定 Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html)。
1. **現有的 Amazon SNS 主題** – 如果您在**主題 arn** 下拉式清單中有現有的 Amazon SNS 主題，請選擇此選項。
1. 在**事件類型**下，選擇：
+ **所有 SMS 事件 （建議）** – 選擇此選項，將 中列出的所有 SMS 事件傳送至 [Event types (事件類型)](configuration-sets-event-types.md) Amazon SNS。
+ **自訂 SMS 事件** – 選擇要傳送至 Amazon SNS 的特定 SMS 事件。若要編輯事件清單，請選擇**編輯 SMS 事件選擇**。在**編輯簡訊事件選取**時，只會檢查您要傳送至 Amazon SNS 的事件。選擇**儲存選擇**。
+ **所有語音事件 （建議）** – 選擇此選項，將 中列出的所有語音事件傳送至 [Event types (事件類型)](configuration-sets-event-types.md) Amazon SNS。
+ **自訂語音事件** – 選擇要傳送至 Amazon SNS 的特定語音事件。若要編輯事件清單，請選擇**編輯語音事件選擇**。在**編輯語音事件選取**時，只會檢查您要傳送到 Amazon SNS 的事件。選擇**儲存選擇**。
+ **所有 MMS 事件 （建議）** – 選擇此選項可將 中列出的所有 MMS 事件傳送至 [Event types (事件類型)](configuration-sets-event-types.md) Amazon SNS。
+ **自訂 MMS 事件** – 選擇要傳送至 Amazon SNS 的特定 MMS 事件。若要編輯事件清單，請選擇**編輯 MMS 事件選擇**。在**編輯 MMS 事件選取**時，只會檢查您要傳送至 Amazon SNS 的事件。選擇**儲存選擇**。
1. 選擇 **建立事件** 。
------
#### [ Create an Amazon SNS event destination (AWS CLI) ]
您可以使用 [create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html) 命令來建立事件目的地。
```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --sns-destination TopicArn=arn:aws:sns:us-east-1:111122223333:snsTopic
```
在上述命令中，進行下列變更：
+ 將 *eventDestinationName* 替換成事件目的地的描述性名稱。
+ 將 *configurationSet* 替換成您要與事件目的地建立關聯的組態集的名稱。
+ 將 *eventTypes* 替換成其中一個 [SMS、MS 和語音的事件類型](configuration-sets-event-types.md) 列出的事件類型。
+ 將 `TopicArn` 的值替換成您要接收事件的 Amazon SNS 主題的 Amazon Resource Name (ARN)。
------
# 在 AWS 最終使用者傳訊簡訊中編輯 Amazon SNS 事件目的地
使用 AWS 最終使用者簡訊 SMS 主控台或 AWS CLI 編輯 Amazon SNS 事件目的地。
------
#### [ Update an Amazon SNS event destination (Console) ]
若要使用 AWS 最終使用者簡訊 SMS 主控台更新 AWS 最終使用者簡訊事件目的地，請依照下列步驟執行：
1. 開啟位於 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 的 AWS 終端使用者簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**組態集**。
1. 在**組態設定**頁面上，選擇要新增事件目的地的組態設定。
1. 在**組態設定**頁面上，選擇要編輯的組態設定。
1. 在**組態設定詳細資訊**頁面上，選擇 Amazon SNS 事件目的地，然後選擇**編輯**。
1. 從**目的地類型**下拉式清單中選擇 Amazon SNS。
1. **新的 Amazon SNS 主題** – 選擇此選項， AWS 最終使用者傳訊簡訊會在您的帳戶中建立主題。系統將自動建立主題，並授予所有必要的許可。如需 Amazon SNS 主題的詳細資訊，請參閱《Amazon [Simple Notification Service ](https://docs.aws.amazon.com/sns/latest/dg/)[開發人員指南》中的設定 Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html)。
1. **現有的 Amazon SNS 主題** – 如果您在**主題 arn** 下拉式清單中有現有的 Amazon SNS 主題，請選擇此選項。
1. 在**事件類型**下，選擇：
+ **所有 SMS 事件 （建議）** – 選擇此選項，將 中列出的所有 SMS 事件傳送至 [Event types (事件類型)](configuration-sets-event-types.md) Amazon SNS。
+ **自訂簡訊事件** – 選擇此選項，選擇要傳送至 Amazon SNS 的特定簡訊事件。若要編輯事件清單，請選擇**編輯簡訊事件選取**項目。在**編輯簡訊事件選取**時，只會檢查您要傳送至 Amazon SNS 的事件。選擇**儲存選擇**。
+ **所有語音事件 （建議）** – 選擇此選項可將 中列出的所有語音事件傳送至 [Event types (事件類型)](configuration-sets-event-types.md) Amazon SNS。
+ **自訂語音事件** – 選擇此選項，選擇要傳送至 Amazon SNS 的特定語音事件。若要編輯事件清單，請選擇**編輯語音事件選擇**。在**編輯語音事件選取**時，只會檢查您要傳送至 Amazon SNS 的事件。選擇**儲存選擇**。
+ **所有 MMS 事件 （建議）** – 選擇此選項可將 中列出的所有 MMS 事件傳送至 [Event types (事件類型)](configuration-sets-event-types.md) Amazon SNS。
+ **自訂 MMS 事件** – 選擇此選項，選擇要傳送至 Amazon SNS 的特定 MMS 事件。若要編輯事件清單，請選擇**編輯 MMS 事件選擇**。在**編輯 MMS 事件選取**時，只會檢查您要傳送至 Amazon SNS 的事件。選擇**儲存選擇**。
1. 選擇**編輯事件**。
------
#### [ Update an Amazon SNS event destination (AWS CLI) ]
您可以使用 [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html) 命令來更新事件目的地。
更新 Amazon SNS 事件目的地的程序，與建立事件目的地的程序類似。
**在 中更新 Amazon SNS 事件目的地 AWS CLI**
+ 在命令列中執行以下命令：
```
$ aws pinpoint-sms-voice-v2 update-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event types eventTypes \
> --sns-destination TopicArn=arn:aws:sns:us-east-1:111122223333:snsTopic
```
在上述命令中，進行下列變更：
+ 將 *eventDestinationName* 替換成您要修改的事件目的地的名稱。
+ 將 *configurationSet* 替換成您要與事件目的地建立關聯的組態集的名稱。您現在可以將事件目的地與不同組態集建立關聯。
+ 將 *eventTypes* 取代為 中列出的一或多個事件類型[SMS、MS 和語音的事件類型](configuration-sets-event-types.md)。
+ 將 `TopicArn` 的值替換成您要接收事件的 Amazon SNS 主題的 Amazon Resource Name (ARN)。
------
# 在 AWS 最終使用者傳訊簡訊中刪除 Amazon SNS 事件目的地
使用 AWS 最終使用者簡訊 SMS 主控台或 AWS CLI 來刪除 Amazon SNS 主題。
------
#### [ Delete an Amazon SNS event destination (Console) ]
不論您要刪除的事件目的地是什麼類型，刪除事件目的地的程序都相同。
**在主控台中刪除 Amazon SNS 事件目的地**
1. 開啟位於 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 的 AWS 終端使用者簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**組態集**。
1. 在**組態設定**頁面上，選擇要從中移除事件目的地的組態設定。
1. **在所有目的地**區段中，選擇事件目的地，然後選擇**刪除**。
------
#### [ Delete an Amazon SNS event destination (AWS CLI) ]
您可以使用 [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html) 命令來刪除事件目的地。
不論您要刪除的事件目的地是什麼類型，刪除事件目的地的程序都相同。
**在 中刪除 Amazon SNS 事件目的地 AWS CLI**
+ 在命令列中執行以下命令：
```
$ aws pinpoint-sms-voice-v2 delete-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSetName
```
在上述命令中，進行下列變更：
+ 將 *eventDestinationName* 的值替換成您要刪除的事件目的地的名稱或 Amazon Resource Name (ARN)。
+ 將 *configurationSetName* 替換成您要與事件目的地建立關聯的名稱或 ARN。
------