本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 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。
------