本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# AWS 最終使用者傳訊簡訊中的事件目的地
*事件目的地*是傳送簡訊和語音事件的位置 （例如 CloudWatch 群組、Amazon Data Firehose 串流或 Amazon SNS 主題）。若要使用事件目的地，請先建立目的地，然後將其與 建立關聯[AWS 最終使用者傳訊簡訊中的組態設定](configuration-sets.md)。您最多可以將五個事件目的地與單一組態集建立關聯。傳送訊息時，對 API 的呼叫包括對組態集的參考。
由電信業者產生的事件或交付接收 (DLR) 最多可能需要 72 小時才會收到，不應用於判斷傳出訊息交付是否有延遲。72 小時後，如果 AWS 最終使用者簡訊簡訊尚未收到電信業者的最終事件，服務將自動傳回 UNKNOWN，`messageStatus`因為我們不知道該訊息發生了什麼。
**先決條件**
您需要已建立組態集，以將事件目的地與 建立關聯，請參閱 [AWS 最終使用者傳訊簡訊中的組態設定](configuration-sets.md)。
**Topics**
+ [Event types (事件類型)](configuration-sets-event-types.md)
+ [範例事件資料](configuration-sets-event-format.md)
+ [設定 Amazon CloudWatch 事件目的地](configuration-sets-cloud-watch.md)
+ [設定 Amazon Data Firehose 事件目的地](configuration-sets-kinesis.md)
+ [設定 Amazon SNS 事件目的地](configuration-sets-sns.md)
# SMS、MS 和語音的事件類型
使用活動目標的最簡單方法，是將所有 SMS、MMS 和語音事件傳送到單一目標。但您可以設定事件目的地，將特定事件類型傳送到不同的目的地。例如，您可以將所有交付相關事件傳送至 Firehose 進行儲存，並將所有失敗事件傳送至 Amazon SNS 主題，以便在發生時收到通知。您也可以將 SMS 事件和語音事件傳送到不同位置。
您可以設定事件目的地，以傳送以下類型的事件：
**SMS、MS 和語音事件**
+ **ALL** – 將所有 SMS、MS 和語音事件傳送至指定的目的地。
**簡訊事件**
+ **TEXT\$1ALL** – 將所有 SMS 事件傳送到指定的目的地。
+ **TEXT\$1DELIVERED （已交付）** – 將所有簡訊交付事件傳送至指定的目的地。視目的地國家/地區而定，**TEXT\$1DELIVERED** 和 **TEXT\$1SUCCESSFUL** 事件可以互換使用。
+ **TEXT\$1SUCCESSFUL （成功）** – 當收件人的電信業者接受訊息時，就會發生成功事件。視目的地國家/地區而定，**TEXT\$1DELIVERED** 和 **TEXT\$1SUCCESSFUL** 事件可以互換使用。
+ **TEXT\$1QUEUED （佇列）** – 當訊息排入交付佇列但尚未交付時，就會發生排入佇列的事件。
+ **TEXT\$1PENDING （待定）** – 當訊息正在交付中，但尚未交付 （或無法交付） 時，會發生待定事件。
+ **TEXT\$1BLOCKED （封鎖）** – 當收件人的裝置或電信業者封鎖傳送給該收件人的訊息時，就會發生封鎖事件。
+ **TEXT\$1TTL\$1EXPIRED (TTL 過期）** – 當傳送訊息所需的時間超過您傳送訊息時指定的`TTL`值時，就會發生 TTL 過期事件。
+ **TEXT\$1CARRIER\$1UNREACHABLE （無法連線電信業者）** – 當訊息收件人的電信業者網路上發生暫時性錯誤時，就會發生電信業者無法連線事件。
+ **TEXT\$1INVALID (SMS 無效）** – 當目的地電話號碼無效時，會發生無效事件。
+ **TEXT\$1INVALID\$1MESSAGE （無效訊息）** – 當簡訊本文無效且無法交付時，會發生無效的訊息事件。
+ **TEXT\$1CARRIER\$1BLOCKED （電信業者封鎖）** – 當收件人的電信業者封鎖訊息傳遞時，就會發生電信業者封鎖事件。電信業者判定訊息是惡意訊息 (例如訊息內含與網路釣魚詐騙相關的資訊) 或濫用 (例如訊息疑似來路不明或含禁止的內容) 時，通常會發生這種情況。
+ **TEXT\$1UNREACHABLE （無法連線）** – 當收件人的裝置無法使用時，就會發生無法連線的事件。如果裝置未連線至行動網路或已關閉電源，則可能發生這種情況。
+ **TEXT\$1SPAM （垃圾郵件）** – 當收件人的電信業者將訊息識別為包含未經要求的商業內容，並封鎖訊息傳遞時，就會發生垃圾郵件事件。
+ **TEXT\$1UNKNOWN （未知）** – 當訊息因其他事件類型之一未涵蓋的原因無法傳遞時發生未知事件。未知錯誤可能是暫時性，也可能是永久性。
+ **TEXT\$1PROTECT\$1BLOCKED （保護封鎖）** – 保護組態封鎖的訊息。
**語音事件**
+ **VOICE\$1ALL** – 將所有語音事件傳送到指定的目的地。
+ **VOICE\$1COMPLETED （已完成）** – 當語音訊息播放給收件人時，就會發生已完成的事件。此狀態不一定表示訊息已交付給人類收件人。例如它可能表示訊息已交付到語音信箱系統。
+ **VOICE\$1ANSWERED (Answered)** – 接聽事件會在收件人接聽電話時發生。
+ **VOICE\$1INITIATED （已啟動）** – 每次啟動語音訊息時，都會將事件傳送至指定的目的地。
+ **VOICE\$1TTL\$1EXPIRED (TTL 過期）** – 當傳送訊息所需的時間超過您傳送訊息時指定的`TTL`值時，就會發生 TTL 過期事件。
+ **VOICE\$1BUSY （忙碌）** – 當收件人的電話線忙碌時，就會發生忙碌事件。
+ **VOICE\$1NO\$1ANSWER （無回應）** – 撥打通話後不會發生任何接聽事件，但收件人 （或其語音信箱系統） 永遠不會接聽。
+ **VOICE\$1RINGING （鈴聲）** – 響鈴事件會在發出通話之後，但在收件人接聽之前發生。
+ **VOICE\$1FAILED （失敗）** – 當訊息無法傳遞時發生失敗事件。
**MMS 事件**
+ **MEDIA\$1ALL** – 將所有 MMS 事件傳送至指定的目的地。
+ **MEDIA\$1PENDING （待定）** – 當訊息正在交付中，但尚未交付 （或無法交付） 時，會發生待定事件。
+ **MEDIA\$1QUEUED （佇列）** – 當訊息排入交付佇列但尚未交付時，就會發生排入佇列的事件。
+ **MEDIA\$1SUCCESSFUL （成功）** – 當收件人的電信業者接受訊息時，就會發生成功事件。
+ **MEDIA\$1DELIVERED （已交付）** – 將所有 MMS 交付事件傳送至指定的目的地。
+ **MEDIA\$1INVALID (MMS 無效）** – 當目的地電話號碼無效時，會發生無效事件。
+ **MEDIA\$1INVALID\$1MESSAGE （無效訊息）** – 當 MMS 訊息的內文無效且無法傳遞時，會發生無效的訊息事件。
+ **MEDIA\$1UNREACHABLE （無法連線）** – 當收件人的裝置無法使用時，就會發生無法連線的事件。如果裝置未連線至行動網路或已關閉電源，則可能發生這種情況。
+ **MEDIA\$1CARRIER\$1UNREACHABLE （無法連線電信業者）** – 當訊息收件人的電信業者網路上發生暫時性錯誤時，就會發生電信業者無法連線事件。
+ **MEDIA\$1BLOCKED （封鎖）** – 當收件人的裝置或電信業者封鎖傳送給該收件人的訊息時，就會發生封鎖事件。
+ **MEDIA\$1CARRIER\$1BLOCKED （電信業者封鎖）** – 當收件人的電信業者封鎖訊息傳遞時，就會發生電信業者封鎖事件。電信業者判定訊息是惡意訊息 (例如訊息內含與網路釣魚詐騙相關的資訊) 或濫用 (例如訊息疑似來路不明或含禁止的內容) 時，通常會發生這種情況。
+ **MEDIA\$1SPAM （垃圾郵件）** – 當收件人的電信業者將訊息識別為包含未經要求的商業內容，並封鎖訊息的傳遞時，就會發生垃圾郵件事件。
+ **MEDIA\$1UNKNOWN （未知）** – 當訊息因其中一個其他事件類型未涵蓋的原因無法傳遞時發生未知事件。未知錯誤可能是暫時性，也可能是永久性。
+ **MEDIA\$1TTL\$1EXPIRED (TTL 過期）** – 當傳送訊息所需的時間超過您傳送訊息時指定的`TTL`值時，就會發生 TTL 過期事件。
+ **MEDIA\$1FILE\$1TYPE\$1UNSUPPORTED （不支援檔案類型）** – 當媒體檔案不是支援的格式時，會發生檔案類型不支援的事件。如需支援的檔案類型清單，請參閱 [MMS 檔案類型、大小和字元限制](mms-limitations-character.md)
+ **MEDIA\$1FILE\$1SIZE\$1EXCEEDED （檔案大小）** – 當媒體檔案大小大於 600 KB 時，就會發生超過檔案大小的事件。
+ **MEDIA\$1FILE\$1INACCESSIBLE （檔案無法存取）** – 當 AWS 最終使用者傳訊簡訊沒有存取檔案的許可時，就會發生檔案無法存取的事件。
# AWS 最終使用者簡訊 SMS 事件資料範例
AWS 最終使用者傳訊 SMS 可以串流 SMS、MS 和語音訊息傳遞的事件資料。由於接收電信業者產生的事件最多可能需要 72 小時，因此您不應該使用這些事件來判斷傳出訊息傳遞是否有延遲。72 小時後，如果 AWS 最終使用者簡訊簡訊尚未收到電信業者的最終事件，服務會自動傳回 ，`UNKNOWN``messageStatus`因為我們不知道該訊息發生了什麼事。
**Topics**
+ [SMS 範例日誌](#configuration-sets-event-format-sms-example)
+ [SMS Protect 範例日誌](#configuration-sets-event-format-sms-protect-example)
+ [語音範例事件日誌](#configuration-sets-event-format-voice-example)
+ [MMS 範例日誌](#configuration-sets-event-format-mms-example)
## SMS 範例日誌
簡訊事件的 JSON 物件包含以下範例所示的資料。
```
{
"eventType": "TEXT_SUCCESSFUL",
"eventVersion": "1.0",
"eventTimestamp": 1686975103470,
"isFinal": true,
"originationPhoneNumber": "+12065550152",
"destinationPhoneNumber": "+14255550156",
"isInternationalSend": false,
"mcc": "310",
"mnc": "800",
"messageId": "862a8790-60c0-4430-9b2b-658bdexample",
"messageRequestTimestamp": 1686975103170,
"messageEncoding": "GSM",
"messageType": "PROMOTIONAL",
"messageStatus": "SUCCESSFUL",
"messageStatusDescription": "Message has been accepted by phone carrier",
"context": {
"account": "bar"
},
"totalMessageParts": 1,
"totalMessagePrice": 0.09582,
"totalCarrierFee": 0.0
}
```
****
| 屬性 | Description |
| --- | --- |
| eventType | 事件的類型。值列於 [SMS、MS 和語音的事件類型](configuration-sets-event-types.md) |
| eventVersion | 事件 JSON 結構描述的版本。 |
| eventTimestamp | 報告事件的時間，以 Unix 時間顯示 (毫秒)。 |
| isFinal | True 如果這是訊息的最終狀態。有中繼訊息狀態，接收最終訊息狀態最多可能需要 72 小時。 |
| originationPhoneNumber | 訊息傳送來源的電話號碼。 |
| destinationPhoneNumber | 您嘗試傳送訊息的電話號碼。 |
| isInternationalSend | True 如果此電話號碼已啟用國際簡訊。 |
| isoCountryCode | 與收件人電話號碼相關聯的國家，以 ISO 3166-1 alpha-2 格式顯示。 |
| mcc | 行動國家/地區代碼會識別電話號碼所屬的國家/地區。此欄位是選用的，可能不存在。 |
| mnc | Mobile Network Codes 可識別行動網路營運商。此欄位是選用的，可能不存在。 |
| messageId | AWS 最終使用者簡訊簡訊在接受訊息時產生的唯一 ID。 |
| messageRequestTimestamp | 收到簡訊請求的時間，以毫秒為單位顯示為 Unix 時間。 |
| messageEncoding | 訊息的編碼。可能的值為 GSM 和 Unicode。如需訊息編碼的詳細資訊，請參閱 [簡訊字元限制](sms-limitations-character.md)。 |
| messageType | 訊息的類型。可能的值為 Promotional (促銷) 和 Transactional (交易)。 |
| messageStatus | 訊息的狀態。可能值為： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| messageStatusDescription | 訊息狀態的描述。 |
| context | 當您傳送訊息時，您可以指定並將記錄的自訂屬性。 |
| totalMessageParts | AWS 最終使用者傳訊簡訊為了傳送訊息而建立的訊息部分數量。 一般而言，簡訊只能包含 160 個 GSM-7 字元或 67 個非 GSM 字元，但這些限制會因國家而異。如果您傳送訊息超過這些限制， AWS 最終使用者傳訊簡訊會自動將訊息分割成較小的部分。收費依傳送的訊息片段數量為準。如需訊息部分的詳細資訊，請參閱 [什麼是每秒訊息部分數 (MPS) 限制](sms-limitations-mps.md)。 |
| totalMessagePrice | 我們向您收取的傳訊費金額。此價格以千分之多少美國分顯示。假設此屬性的值是 645，則我們收取的傳訊費用是 0.645¢ (645/1000 = 0.645¢ = \$10.00645)。 |
| totalCarrierFee | 訊息的電信業者費用總成本。 |
## SMS Protect 範例日誌
使用 SMS [Protect](protect.md) 時 SMS 事件的 JSON 物件包含下列範例所示的資料。
```
{
"eventType": "TEXT_PROTECT_BLOCKED",
"eventVersion": "1.0",
"eventTimestamp": 1686975103470,
"isFinal": true,
"originationPhoneNumber": "+12065550152",
"destinationPhoneNumber": "+14255550156",
"isoCountryCode": "US",
"mcc": "310",
"mnc": "800",
"messageId": "862a8790-60c0-4430-9b2b-658bdexample",
"messageRequestTimestamp": 1686975103170,
"messageEncoding": "GSM",
"messageType": "PROMOTIONAL",
"messageStatus": "PROTECT_BLOCKED",
"messageStatusDescription": "Message blocked by protect configuration",
"context": {
"account": "bar"
},
"totalMessageParts": 1,
"totalMessagePrice": 0,
"totalCarrierFee": 0,
"protectConfiguration": {
"protectConfigurationId": "protect-d777777777777771bbd5d59f4d903479",
"protectStatus": "FILTER"
},
"protectConfigurationAssessment": {
"protectRecommendation": "BLOCK"
"protectInsights": {
"blockReason": "AIT_SUSPECTED"
}
}
}
```
****
| 屬性 | Description |
| --- | --- |
| eventType | 事件的類型。值列於 [SMS、MS 和語音的事件類型](configuration-sets-event-types.md) |
| eventVersion | 事件 JSON 結構描述的版本。 |
| eventTimestamp | 報告事件的時間，以 Unix 時間顯示 (毫秒)。 |
| isFinal | True 如果這是訊息的最終狀態。有中繼訊息狀態，接收最終訊息狀態最多可能需要 72 小時。 |
| originationPhoneNumber | 訊息傳送來源的電話號碼。 |
| destinationPhoneNumber | 您嘗試傳送訊息的電話號碼。 |
| isoCountryCode | 與收件人電話號碼相關聯的國家，以 ISO 3166-1 alpha-2 格式顯示。 |
| mcc | 行動國家/地區代碼會識別電話號碼所屬的國家/地區。此欄位是選用的，可能不存在。 |
| mnc | Mobile Network Codes 可識別行動網路營運商。此欄位是選用的，可能不存在。 |
| messageId | AWS 最終使用者簡訊簡訊在接受訊息時產生的唯一 ID。 |
| messageRequestTimestamp | 收到簡訊請求的時間，以毫秒為單位顯示為 Unix 時間。 |
| messageEncoding | 訊息的編碼。可能的值為 GSM 和 Unicode。如需訊息編碼的詳細資訊，請參閱 [簡訊字元限制](sms-limitations-character.md)。 |
| messageType | 訊息的類型。可能的值為 Promotional (促銷) 和 Transactional (交易)。 |
| messageStatus | 訊息的狀態。可能值為： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| messageStatusDescription | 訊息狀態的描述。 |
| context | 當您傳送訊息時，您可以指定並將記錄的自訂屬性。 |
| totalMessageParts | AWS 最終使用者傳訊簡訊為了傳送訊息而建立的訊息部分數量。 一般而言，簡訊只能包含 160 個 GSM-7 字元或 67 個非 GSM 字元，但這些限制會因國家而異。如果您傳送訊息超過這些限制， AWS 最終使用者傳訊簡訊會自動將訊息分割成較小的部分。收費依傳送的訊息片段數量為準。如需訊息部分的詳細資訊，請參閱 [什麼是每秒訊息部分數 (MPS) 限制](sms-limitations-mps.md)。 |
| totalMessagePrice | 我們向您收取的傳訊費金額。此價格以千分之多少美國分顯示。假設此屬性的值是 645，則我們收取的傳訊費用是 0.645¢ (645/1000 = 0.645¢ = \$10.00645)。 |
| totalCarrierFee | 訊息的電信業者費用總成本。 |
| protectConfiguration | 傳送訊息時所使用的保護組態 ID，以及目的地國家/地區當時的狀態。如需 SMS Protect 的詳細資訊，請參閱 [SMS Protect](protect.md)。 |
| protectConfigurationAssessment | 評估 SMS Protect 是否認為您的訊息應允許或封鎖傳送，以及可用時的封鎖原因。 |
## 語音範例事件日誌
語音事件的 JSON 物件包含下列範例所示的資料。
```
{
"eventType": "VOICE_COMPLETED",
"eventVersion": "1.0",
"eventTimestamp": 1697835373500,
"isFinal": true,
"originationPhoneNumber": "+12065550153",
"destinationPhoneNumber": "+14255550159",
"isoCountryCode": "US",
"messageId": "567f6c11-6e8b-4352-9749-a42a0example",
"messageRequestTimestamp": 1697835372720,
"messageStatus": "COMPLETED",
"callDurationInSeconds": 60,
"totalDurationInMinutes": 1,
"totalMessagePrice": 0.013,
"context": {
"account": "bar"
}
}
```
****
| 屬性 | Description |
| --- | --- |
| eventType | 事件的類型。值列於 [SMS、MS 和語音的事件類型](configuration-sets-event-types.md) |
| eventVersion | 事件 JSON 結構描述的版本。 |
| eventTimestamp | 報告事件的時間，以 Unix 時間顯示 (毫秒)。 |
| isFinal | True 如果這是訊息的最終狀態。有中繼訊息狀態。 |
| originationPhoneNumber | 訊息傳送來源的電話號碼。 |
| destinationPhoneNumber | 您嘗試傳送訊息的電話號碼。 |
| isoCountryCode | 與收件人電話號碼相關聯的國家，以 ISO 3166-1 alpha-2 格式顯示。 |
| messageId | AWS 最終使用者簡訊簡訊在接受訊息時產生的唯一 ID。 |
| messageRequestTimestamp | 收到簡訊請求的時間，以毫秒為單位顯示為 Unix 時間。 |
| messageStatus | 訊息的狀態。可能值為： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| callDurationInSeconds | 呼叫的持續時間，以秒為單位。 |
| totalDurationInMinutes | 呼叫的持續時間，以分鐘為單位。 |
| totalMessagePrice | 我們向您收取的語音訊息傳送費用。此價格以千分之多少美國分顯示。 |
| context | 當您傳送訊息時，您可以指定並將記錄的自訂屬性。 |
## MMS 範例日誌
MMS 事件的 JSON 物件包含下列範例所示的資料。
```
{
"contentType":"MMS",
"eventType": "MEDIA_DELIVERED",
"eventVersion": "1.0",
"eventTimestamp": 1635197695208,
"isFinal": true,
"originationPhoneNumber": "+12065550153",
"destinationPhoneNumber": "+14255550159",
"isoCountryCode": "US",
"messageId": "b4a3196d-5b61-4884-a0d9-745acf1f6235example",
"messageRequestTimestamp": 1635197693241,
"messageType": "TRANSACTIONAL",
"messageStatus": "DELIVERED",
"messageStatusDescription": "Message has been accepted by phone",
"context": {"foo":"bar"},
"totalMessageParts": 1,
"totalMessagePrice": 0.0195,
"totalCarrierFee": 0.00266
}
```
****
| 屬性 | Description |
| --- | --- |
| eventType | 事件的類型。值列於 [SMS、MS 和語音的事件類型](configuration-sets-event-types.md) |
| eventVersion | 事件 JSON 結構描述的版本。 |
| eventTimestamp | 報告事件的時間，以 Unix 時間顯示 (毫秒)。 |
| isFinal | True 如果這是訊息的最終狀態。有中繼訊息狀態，接收最終訊息狀態最多可能需要 72 小時。 |
| originationPhoneNumber | 訊息傳送來源的電話號碼。 |
| destinationPhoneNumber | 您嘗試傳送訊息的電話號碼。 |
| isoCountryCode | 與收件人電話號碼相關聯的國家，以 ISO 3166-1 alpha-2 格式顯示。 |
| messageId | AWS 最終使用者簡訊簡訊在接受訊息時產生的唯一 ID。 |
| messageRequestTimestamp | 收到簡訊請求的時間，以毫秒為單位顯示為 Unix 時間。 |
| messageType | 訊息的類型。可能的值為 Promotional (促銷) 和 Transactional (交易)。 |
| messageStatus | 訊息的狀態。可能值為： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| messageStatusDescription | 訊息狀態的描述。 |
| context | 您可以在傳送訊息時指定和記錄自訂屬性。 |
| totalMessageParts | AWS 最終使用者傳訊簡訊為了傳送訊息而建立的訊息部分數量。如需訊息部分的詳細資訊，請參閱 [什麼是每秒訊息部分數 (MPS) 限制](sms-limitations-mps.md)。 |
| totalMessagePrice | 我們向您收取的傳訊費金額。此價格以千分之多少美國分顯示。假設此屬性的值是 645，則我們收取的傳訊費用是 0.645¢ (645/1000 = 0.645¢ = \$10.00645)。 |
| totalCarrierFee | 訊息的電信業者費用總成本。 |
# 在 AWS 最終使用者傳訊簡訊中設定 Amazon CloudWatch 事件目的地
Amazon CloudWatch Logs 是一項 AWS 服務，可用來監控、存放和存取日誌檔案。當您建立 CloudWatch 事件目的地時， AWS 最終使用者傳訊簡訊會將您在事件目的地中指定的事件類型傳送至 CloudWatch 群組。若要進一步了解 CloudWatch，請參閱 [Amazon CloudWatch Logs 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/)。
**先決條件**
1. 您必須先建立 CloudWatch 群組，才能建立 CloudWatch 事件目的地。如需建立日誌群組的詳細資訊，請參閱 *Amazon CloudWatch Logs 使用者指南*中的[使用日誌群組和日誌串流工作](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)。
**重要**
您需要 CloudWatch 群組的 Amazon Resource Name (ARN) 才能建立事件目的地。
1. 您必須建立允許 AWS 最終使用者傳訊 SMS 寫入日誌群組的 [IAM 角色](configuration-sets-cloud-watch-creating-role.md#configuration-sets-cloud-watch-creating-role.title)。
**重要**
您需要 IAM 角色的 Amazon Resource Name (ARN) 才能建立事件目的地。
1. 您也已設定組態集，將事件目的地與 建立關聯，請參閱 [在 AWS 最終使用者傳訊簡訊中建立組態設定](configuration-set-create.md)。
# Amazon CloudWatch 的 IAM 政策
使用下列範例建立將事件傳送至 CloudWatch 群組的政策。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"logs:CreateLogStream",
"logs:DescribeLogStreams",
"logs:PutLogEvents"
],
"Resource": [
"arn:aws:logs:us-east-1:111122223333:log-group:log-group-name:*"
]
}
]
}
```
------
如需 IAM 政策的詳細資訊，請參閱 *IAM 使用者指南*中的 [IAM 中的政策和許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)。
下列範例陳述式使用 、選用但建議使用的 `SourceAccount`和 `SourceArn`條件，來檢查只有 AWS 最終使用者傳訊簡訊擁有者帳戶可以存取組態設定。在此範例中，將 *accountId* 取代為 AWS 您的帳戶 ID，將 *region* 取代為 AWS 區域 名稱，將 *ConfigSetName* 取代為組態集的名稱。
建立政策之後，再建立新的 IAM 角色並連接政策。建立角色時，亦請將以下信任政策加入角色：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "111122223333"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
}
}
}
}
```
------
如需建立 IAM 角色的詳細資訊，請參閱 *IAM 使用者指南*中的[建立 IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html)。
# 在 AWS 最終使用者傳訊簡訊中建立 Amazon CloudWatch 事件目的地
建立 IAM 角色和 CloudWatch 群組之後，您可以建立事件目的地。
------
#### [ Create event destination (Console) ]
若要使用 AWS 最終使用者簡訊 SMS 主控台建立事件目的地，請遵循下列步驟：
1. 在 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 開啟 AWS 最終使用者傳訊簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**組態集**。
1. 在**組態集**頁面上，選擇要將事件目的地新增至其中的組態集。
1. 在**組態設定詳細資訊**頁面上，選擇**新增目的地事件**。
1. 在**事件詳細資訊**區段下，輸入**事件目的地名稱的易記名稱**。
1. 從**目的地類型**下拉式清單中選擇 Amazon CloudWatch。
1. 對於 **IAM 角色 arn**，輸入 IAM 角色的 ARN。如需 IAM 角色 arn 的詳細資訊，請參閱 [Amazon CloudWatch 的 IAM 政策](configuration-sets-cloud-watch-creating-role.md)。
1. 對於**日誌群組 arn**，輸入要交付事件的 Amazon CloudWatch 日誌群組 ARN。
1. 開啟**事件發佈**。
1. 在**事件類型**下，選擇：
+ **所有 SMS 事件 （建議）** – 選擇此選項可將 中列出的所有 SMS 事件傳送至 [Event types (事件類型)](configuration-sets-event-types.md) Amazon CloudWatch。
+ **自訂簡訊事件** – 選擇要傳送至 CloudWatch 的特定簡訊事件。若要編輯事件清單，請選擇**編輯簡訊事件選擇**。在**編輯簡訊事件選取**時，只會檢查您要傳送至 Amazon CloudWatch 的事件。選擇**儲存選擇**。
+ **所有語音事件 （建議）** – 選擇此選項可將 中列出的所有語音事件傳送至 [Event types (事件類型)](configuration-sets-event-types.md) Amazon CloudWatch。
+ **自訂語音事件** – 選擇要傳送至 CloudWatch 的特定語音事件。若要編輯事件清單，請選擇**編輯語音事件選擇**。在**編輯語音事件選取**時，只會檢查您要傳送至 Amazon CloudWatch 的事件。選擇**儲存選擇**。
+ **所有 MMS 事件 （建議）** – 選擇此選項可將 中列出的所有 MMS 事件傳送至 [Event types (事件類型)](configuration-sets-event-types.md) Amazon CloudWatch。
+ **自訂 MMS 事件** – 選擇要傳送至 CloudWatch 的特定 MMS 事件。若要編輯事件清單，請選擇**編輯 MMS 事件選擇**。在**編輯 MMS 事件選取**時，只會檢查您要傳送至 Amazon CloudWatch 的事件。選擇**儲存選擇**。
1. 選擇 **建立事件** 。
------
#### [ Create 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 \
> --cloud-watch-logs-destination IamRoleArn=arn:aws:iam::111122223333:role/CWLSMSRole,LogGroupArn=arn:aws:logs:us-east-1:111122223333:log-group:MyCWLLogGroup
```
在上述命令中，進行下列變更：
+ 將 *eventDestinationName* 替換成描述事件目的地的名稱。
+ 將 *configurationSet* 替換成您要與事件目的地建立關聯的組態集的名稱。
+ 將 *eventTypes* 取代為 中列出的一或多個事件類型[SMS、MS 和語音的事件類型](configuration-sets-event-types.md)。
+ 將 `IamRoleArn` 的值替換成 IAM 角色的 Amazon Resource Name (ARN) (該 ARN 具有 [Amazon CloudWatch 的 IAM 政策](configuration-sets-cloud-watch-creating-role.md) 中描述的政策)。
+ 將 的值取代`LogGroupArn`為您要傳送事件的 CloudWatch 群組的 ARN。
------
# 在 AWS 最終使用者傳訊簡訊中編輯 Amazon CloudWatch 事件目的地
使用 AWS 最終使用者傳訊簡訊主控台或 AWS CLI 編輯 CloudWatch 事件目的地。
------
#### [ Update event destination (Console) ]
若要使用 AWS 最終使用者簡訊 SMS 主控台更新事件目的地，請遵循下列步驟：
1. 在 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 開啟 AWS 最終使用者傳訊簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**組態集**。
1. 在**組態設定**頁面上，選擇要編輯的組態設定。
1. 在**事件設定**索引標籤上，選擇 Amazon CloudWatch 事件目的地，然後選擇**編輯**。
1. 對於 **IAM 角色 arn**，輸入 IAM 角色的 ARN。如需 IAM 角色 arn 的詳細資訊，請參閱 [Amazon CloudWatch 的 IAM 政策](configuration-sets-cloud-watch-creating-role.md)。
1. 對於**日誌群組 arn**，輸入要交付事件的 Amazon CloudWatch 日誌群組 ARN。
1. 在**事件類型**下，選擇：
+ **所有簡訊事件 （建議）** – 選擇此選項，將 中列出的所有簡訊事件傳送至 [Event types (事件類型)](configuration-sets-event-types.md) Amazon CloudWatch。
+ **自訂簡訊事件** – 選擇此選項，選擇要傳送至 CloudWatch 的特定簡訊事件。若要編輯事件清單，請選擇**編輯簡訊事件選擇**。在**編輯簡訊事件選取**時，僅檢查您要傳送至 Amazon CloudWatch 的事件。選擇**儲存選擇**。
+ **所有語音事件 （建議）** – 選擇此選項可將 中列出的所有語音事件傳送至 [Event types (事件類型)](configuration-sets-event-types.md) Amazon CloudWatch。
+ **自訂語音事件** – 選擇此選項，選擇要傳送至 CloudWatch 的特定語音事件。若要編輯事件清單，請選擇**編輯語音事件選擇**。在**編輯語音事件選取**時，只會檢查您要傳送至 Amazon CloudWatch 的事件。選擇**儲存選擇**。
+ **所有 MMS 事件 （建議）** – 選擇此選項可將 中列出的所有 MMS 事件傳送至 [Event types (事件類型)](configuration-sets-event-types.md) Amazon CloudWatch。
+ **自訂 MMS 事件** – 選擇此選項，選擇要傳送至 CloudWatch 的特定 MMS 事件。若要編輯事件清單，請選擇**編輯 MMS 事件選擇**。在**編輯 MMS 事件選取**時，只會檢查您要傳送至 Amazon CloudWatch 的事件。選擇**儲存選擇**。
1. 選擇**編輯事件**。
------
#### [ Update event destination AWS CLI) ]
您可以使用 [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html) 命令來更新事件目的地。
更新 CloudWatch 事件目的地的程序類似於建立事件目的地的程序。在命令列中執行以下命令：
```
$ aws pinpoint-sms-voice-v2 update-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event types eventTypes \
> --cloud-watch-logs-destination IamRoleArn=arn:aws:iam::111122223333:role/CWLSMSRole,LogGroupArn=arn:aws:logs:us-east-1:111122223333:log-group:MyCWLLogGroup
```
在上述命令中，進行下列變更：
+ 將 *eventDestinationName* 替換成您要修改的事件目的地的名稱。
+ 將 *configurationSet* 替換成您要與事件目的地建立關聯的組態集的名稱。您現在可以將事件目的地與不同組態集建立關聯。
+ 將 *eventTypes* 替換成其中一個 [SMS、MS 和語音的事件類型](configuration-sets-event-types.md) 列出的事件類型。
+ 將 `IamRoleArn` 的值替換成 IAM 角色的 Amazon Resource Name (ARN) (該 ARN 具有 [SMS、MS 和語音的事件類型](configuration-sets-event-types.md) 中描述的政策)。
+ 將 的值取代`LogGroupArn`為您要傳送事件之 CloudWatch 群組的 ARN。
------
# 在 AWS 最終使用者傳訊簡訊中刪除 Amazon CloudWatch 事件目的地
使用 AWS 最終使用者傳訊簡訊主控台或 AWS CLI 來刪除 CloudWatch 事件目的地。
------
#### [ Delete an CloudWatch event destination (Console) ]
不論您要刪除的事件目的地是什麼類型，刪除事件目的地的程序都相同。
**在主控台中刪除 CloudWatch 事件目的地**
1. 在 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 開啟 AWS 最終使用者傳訊簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**組態集**。
1. 在**組態集**頁面上，選擇要從中移除事件目的地的組態集。
1. **在所有目的地**區段中，選擇事件目的地，然後選擇**刪除**。
------
#### [ Delete an CloudWatch event destination (AWS CLI) ]
您可以使用 [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html) 命令來刪除事件目的地。
不論您要刪除的事件目的地是什麼類型，刪除事件目的地的程序都相同。
**在 中刪除 CloudWatch 事件目的地 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。
------
# 在 AWS 最終使用者傳訊簡訊中設定 Amazon Data Firehose 事件目的地
Amazon Data Firehose 是一項全受管服務，可將即時串流資料交付至多種類型的目的地。Amazon Data Firehose 是 Kinesis 串流資料平台的一部分。若要進一步了解 Amazon Data Firehose，請參閱 [Amazon Data Firehose 開發人員指南](https://docs.aws.amazon.com/firehose/latest/dev/)。
本節中的一些範例假設您已安裝並設定 AWS Command Line Interface。如需設定 的詳細資訊 AWS CLI，請參閱 [AWS Command Line Interface 使用者指南](https://docs.aws.amazon.com/cli/latest/userguide/)。
**先決條件**
1. 您必須先建立 Amazon Data Firehose 交付串流，才能建立 Amazon Data Firehose 事件目的地。如需建立串流的詳細資訊，請參閱[《Amazon Data Firehose 開發人員指南》中的建立 Amazon Data Firehose 交付串流](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html)。 **
**重要**
您需要 Amazon Data Firehose 交付串流的 Amazon Resource Name (ARN) 才能建立事件目的地。
1. 您必須建立允許 AWS 最終使用者傳訊 SMS 寫入交付串流的 IAM 角色，請參閱 [Amazon Data Firehose 的 IAM 政策](configuration-sets-kinesis-creating-role.md)。
**重要**
您需要 IAM 角色的 Amazon Resource Name (ARN) 才能建立事件目的地。
1. 您也已設定組態集，將事件目的地與 建立關聯，請參閱 [在 AWS 最終使用者傳訊簡訊中建立組態設定](configuration-set-create.md)。
**Topics**
+ [Amazon Data Firehose 的 IAM 政策](configuration-sets-kinesis-creating-role.md)
+ [建立 Amazon Data Firehose 事件目的地](configuration-set-kinesis-add.md)
+ [編輯 Amazon Data Firehose 事件目的地](configuration-set-kinesis-edit.md)
+ [刪除 Amazon Data Firehose 事件目的地](configuration-set-kinesis-delete.md)
# Amazon Data Firehose 的 IAM 政策
使用下列範例建立將事件傳送至 Amazon Data Firehose 串流的政策。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "firehose:PutRecord",
"Resource": "arn:aws:firehose:us-east-1:111122223333:deliverystream/DeliveryStreamName"
}
]
}
```
------
如需 IAM 政策的詳細資訊，請參閱 *IAM 使用者指南*中的 [IAM 中的政策和許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)。
下列範例陳述式使用 、選用但建議使用的 `SourceAccount`和 `SourceArn`條件，來檢查只有 AWS 最終使用者傳訊簡訊擁有者帳戶可以存取組態設定。在此範例中，將 *accountId* 取代為 AWS 您的帳戶 ID，將 *region* 取代為 AWS 區域 名稱，將 *ConfigSetName* 取代為組態集的名稱。
建立政策之後，再建立新的 IAM 角色並連接政策。建立角色時，亦請將以下信任政策加入角色：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "111122223333"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
}
}
}
}
```
------
如需建立 IAM 角色的詳細資訊，請參閱 *IAM 使用者指南*中的[建立 IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html)。
# 在 AWS 最終使用者傳訊簡訊中建立 Amazon Data Firehose 事件目的地
您必須先建立 Amazon Data Firehose 串流，才能建立 Amazon Data Firehose 事件目的地。如需建立日誌群組的詳細資訊，請參閱[《Amazon Data Firehose 開發人員指南》中的建立 Amazon Data Firehose 交付串流](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html)。 **
您必須建立 IAM 角色，允許 AWS 最終使用者傳訊 SMS 和語音 v2 API 將資料傳送至串流。下節包含的資訊，包括對此角色的要求。
您也已經設定了一個組態集，並與事件目的地建立關聯，詳情請參閱 [AWS 最終使用者傳訊簡訊中的組態設定](configuration-sets.md)。
------
#### [ Create Amazon Data Firehose event destination (Console) ]
若要使用 AWS 最終使用者簡訊 SMS 主控台建立 Amazon Data Firehose 事件目的地，請遵循下列步驟：
1. 開啟位於 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 的 AWS 終端使用者簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**組態集**。
1. 在**組態設定**頁面上，選擇要新增事件目的地的組態設定。
1. 在**組態設定詳細資訊**頁面上，選擇**新增目的地事件**。
1. 在**事件詳細資訊**區段下，輸入**事件目的地名稱的易記名稱**。
1. 從**目的地類型**下拉式清單中選擇 Amazon Data Firehose。
1. 針對 **IAM 角色 arn**，輸入 IAM 角色的 ARN。如需 IAM 角色 arn 的詳細資訊，請參閱 [Amazon Data Firehose 的 IAM 政策](configuration-sets-kinesis-creating-role.md)。
1. 針對**交付串流 arn**，輸入要交付事件的 Amazon Data Firehose 日誌群組 ARN。
1. 開啟**事件發佈**。
1. 在**事件類型**下，選擇：
+ **所有 SMS 事件 （建議）** – 選擇此選項，將 中列出的所有 SMS 事件傳送至 [Event types (事件類型)](configuration-sets-event-types.md) Amazon Data Firehose。
+ **自訂簡訊事件** – 選擇要傳送至 Amazon Data Firehose 的特定簡訊事件。若要編輯事件清單，請選擇**編輯 SMS 事件選擇**。在**編輯簡訊事件選取**時，僅檢查您要傳送至 Amazon Data Firehose 的事件。選擇**儲存選擇**。
+ **所有語音事件 （建議）** – 選擇此選項可將 中列出的所有語音事件傳送至 [Event types (事件類型)](configuration-sets-event-types.md) Amazon Data Firehose。
+ **自訂語音事件** – 選擇要傳送至 Amazon Data Firehose 的特定語音事件。若要編輯事件清單，請選擇**編輯語音事件選擇**。在**編輯語音事件選取**時，只會檢查您要傳送至 Amazon Data Firehose 的事件。選擇**儲存選擇**。
+ **所有 MMS 事件 （建議）** – 選擇此選項可將 中列出的所有 MMS 事件傳送至 [Event types (事件類型)](configuration-sets-event-types.md) Amazon Data Firehose。
+ **自訂 MMS 事件** – 選擇要傳送至 Amazon Data Firehose 的特定 MMS 事件。若要編輯事件清單，請選擇**編輯 MMS 事件選擇**。在**編輯 MMS 事件選取**時，只會檢查您要傳送至 Amazon Data Firehose 的事件。選擇**儲存選擇**。
1. 選擇 **建立事件** 。
------
#### [ Create Amazon Data Firehose event destination (AWS CLI) ]
建立 IAM 角色和 Amazon Data Firehose 交付串流之後，您可以建立事件目的地。
您可以使用 [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 \
> --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream
```
在上述命令中，進行下列變更：
+ 將 *eventDestinationName* 替換成描述事件目的地的名稱。
+ 將 *configurationSet* 替換成您要與事件目的地建立關聯的組態集的名稱。
+ 將 *eventTypes* 取代為 中列出的一或多個事件類型[SMS、MS 和語音的事件類型](configuration-sets-event-types.md)。
+ 將 `IamRoleArn` 的值替換成 IAM 角色的 Amazon Resource Name (ARN) (該 ARN 具有 [Amazon Data Firehose 的 IAM 政策](configuration-sets-kinesis-creating-role.md) 中描述的政策)。
+ 將 的值取代`DeliveryStreamArn`為您要傳送事件的 Amazon Data Firehose 串流 ARN。
------
# 在 AWS 最終使用者傳訊簡訊中編輯 Amazon Data Firehose 事件目的地
使用 AWS 最終使用者簡訊 SMS 主控台或 AWS CLI 編輯 Amazon Data Firehose 事件目的地。
------
#### [ Update Amazon Data Firehose event destination (Console) ]
若要使用 AWS 最終使用者簡訊 SMS 主控台更新 Amazon Data Firehose 事件目的地，請遵循下列步驟：
1. 開啟位於 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 的 AWS 終端使用者簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**組態集**。
1. 在**組態設定**頁面上，選擇要新增事件目的地的組態設定。
1. 在**組態設定**頁面上，選擇要編輯的組態設定。
1. 在**組態設定詳細資訊**頁面上，選擇 Amazon Data Firehose 事件目的地，然後選擇**編輯**。
1. 針對 **IAM 角色 arn**，輸入 IAM 角色的 ARN。如需 IAM 角色 arn 的詳細資訊，請參閱 [Amazon Data Firehose 的 IAM 政策](configuration-sets-kinesis-creating-role.md)。
1. 針對**交付串流 arn**，輸入要交付事件的 Amazon Data Firehose 日誌群組 ARN。
1. 在**事件類型**下，選擇：
+ **所有 SMS 事件 （建議）** – 選擇此選項，將 中列出的所有 SMS 事件傳送至 [Event types (事件類型)](configuration-sets-event-types.md) Amazon Data Firehose。
+ **自訂簡訊事件** – 選擇此選項，選擇要傳送至 CloudWatch 的特定簡訊事件。若要編輯事件清單，請選擇**編輯 SMS 事件選擇**。在**編輯簡訊事件選取**時，僅檢查您要傳送至 Amazon Data Firehose 的事件。選擇**儲存選擇**。
+ **所有語音事件 （建議）** – 選擇此選項可將 中列出的所有語音事件傳送至 [Event types (事件類型)](configuration-sets-event-types.md) Amazon Data Firehose。
+ **自訂語音事件** – 選擇此選項，選擇要傳送至 Amazon Data Firehose 的特定語音事件。若要編輯事件清單，請選擇**編輯語音事件選擇**。在**編輯語音事件選取**時，只會檢查您要傳送至 Amazon Data Firehose 的事件。選擇**儲存選擇**。
+ **所有 MMS 事件 （建議）** – 選擇此選項可將 中列出的所有 MMS 事件傳送至 [Event types (事件類型)](configuration-sets-event-types.md) Amazon Data Firehose。
+ **自訂 MMS 事件** – 選擇此選項，選擇要傳送至 CloudWatch 的特定 MMS 事件。若要編輯事件清單，請選擇**編輯 MMS 事件選擇**。在**編輯 MMS 事件選取**時，只會檢查您要傳送至 Amazon Data Firehose 的事件。選擇**儲存選擇**。
1. 選擇**編輯事件**。
------
#### [ Update Amazon Data Firehose event destination (AWS CLI) ]
您可以使用 [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html) 命令來更新事件目的地。
更新 Amazon Data Firehose 事件目的地的程序類似於建立事件目的地的程序。
```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream
```
在上述命令中，進行下列變更：
+ 將 *eventDestinationName* 替換成您要修改的事件目的地的名稱。
+ 將 *configurationSet* 替換成您要與事件目的地建立關聯的組態集的名稱。您現在可以將事件目的地與不同組態集建立關聯。
+ 將 *eventTypes* 替換成其中一個 [SMS、MS 和語音的事件類型](configuration-sets-event-types.md) 列出的事件類型。
+ 將 `IamRoleArn` 的值替換成 IAM 角色的 Amazon Resource Name (ARN) (該 ARN 具有 [Amazon Data Firehose 的 IAM 政策](configuration-sets-kinesis-creating-role.md) 中描述的政策)。
+ 將 的值取代`DeliveryStreamArn`為您要傳送事件的 Amazon Data Firehose 串流 ARN。
------
# 在 AWS 最終使用者簡訊 SMS 中刪除 Amazon Data Firehose 事件目的地
使用 AWS 最終使用者簡訊 SMS 主控台或 AWS CLI 來刪除 Amazon Data Firehose 事件目的地。
------
#### [ Delete an Amazon Data Firehose event destination (Console) ]
不論您要刪除的事件目的地是什麼類型，刪除事件目的地的程序都相同。
**在主控台中刪除 Amazon Data Firehose 事件目的地**
1. 開啟位於 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 的 AWS 終端使用者簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**組態集**。
1. 在**組態設定**頁面上，選擇要從中移除事件目的地的組態設定。
1. **在所有目的地**區段中，選擇事件目的地，然後選擇**刪除**。
------
#### [ Delete an Amazon Data Firehose event destination (AWS CLI) ]
您可以使用 [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html) 命令來刪除事件目的地。
不論您要刪除的事件目的地是什麼類型，刪除事件目的地的程序都相同。
**在 中刪除 Amazon Data Firehose 事件目的地 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。
------
# 在 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。
------