建立 Amazon 資料 Firehose 事件目的地管理 Amazon 數據 Firehose 事件目的地

Amazon 資料 Firehose 活動目的地

Amazon Data Firehose 是一項全受管服務，可將即時串流資料傳送到多種類型的目的地。Amazon 資料 Firehose 是 Kinesis 串流資料平台的一部分。若要進一步了解 Amazon 資料 Firehose，請參閱 Amazon 資料 Firehose 開發人員指南。

本節中的一些範例假設您已經安裝並設定了 AWS Command Line Interface. 若要取得有關設定的更多資訊 AWS CLI，請參閱《AWS Command Line Interface 使用者指南》。

先決條件

您必須先建立 Amazon 資料 Firehose 交付串流，才能建立 Amazon 資料 Firehose 事件目的地。如需有關建立串流的詳細資訊，請參閱 Amazon 資料 Firehose 開發人員指南中的建立 Amazon 資料 Firehose 交付串流。

重要
您需要 Amazon 資料 Firehose 交付串流的 Amazon 資源名稱 (ARN)，才能建立事件目的地。
您必須建立允許「一 AWS 般使用者訊息」寫SMS入傳遞串流的IAM角色，請參閱IAMAmazon 數據 Firehose 政策。

重要
您需要IAM角色的 Amazon 資源名稱 (ARN) 來建立事件目的地。
您還可以設置一個配置集來將事件目的地與之關聯，請參閱管理組態集。

建立 Amazon 資料 Firehose 事件目的地

您必須先建立 Amazon 資料 Firehose 串流，才能建立 Amazon 資料 Firehose 事件目的地。如需有關建立日誌群組的詳細資訊，請參閱 Amazon 資料 Firehose 開發人員指南中的建立 Amazon 資料 Fire hose 交付串流。

您必須建立可讓使用 AWS 者訊息SMS和語音 v2 傳送資料API至串流的IAM角色。下節包含的資訊，包括對此角色的要求。

您也已經設定了一個組態集，並與事件目的地建立關聯，詳情請參閱組態集。

IAMAmazon 數據 Firehose 政策

使用下列範例建立將事件傳送至 Amazon 資料 Firehose 串流的政策。


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "firehose:PutRecord",
            "Resource": "arn:aws:firehose:us-east-1:111122223333:deliverystream/DeliveryStreamName"
        }
    ]
}

如需有關IAM策略的詳細資訊，請參閱《IAM使用指南》IAM中的「策略和權限」。

下列範例陳述式會使用選擇性但建議的SourceAccount和SourceArn條件來檢查只有一 AWS 般使用者訊息SMS擁有者帳戶可以存取組態集。在此範例中，取代 accountId 使用您的 AWS 帳戶 ID，region 使用 AWS 區域名稱和 ConfigSetName 使用「組態集」的名稱。

建立原則之後，請建立新IAM角色，然後將原則附加至該原則。建立角色時，亦請將以下信任政策加入角色：


{
    "Version": "2012-10-17",
    "Statement": {
        "Effect": "Allow",
        "Principal": {
            "Service": "sms-voice.amazonaws.com"
        },
        "Action": "sts:AssumeRole",
        "Condition": {
            "StringEquals": {
               "aws:SourceAccount": "accountId"
             },
             "ArnLike": {
               "aws:SourceArn": "arn:aws:sms-voice:region:accountId:configuration-set/ConfigSetName"
              }
        }
    }
}

有關建立IAM角色的詳細資訊，請參閱《IAM使用指南》中的〈建立IAM角色〉。

管理 Amazon 數據 Firehose 事件目的地

Create Amazon Data Firehose event destination (Console)

若要使用一 AWS 般使用者簡訊SMS主控台建立 Amazon Data Firehose 事件目的地，請依照下列步驟執行：

在開啟「一 AWS 般使用者通訊SMS主控台」https://console.aws.amazon.com/sms-voice/。
在導覽窗格的 [組態] 下，選擇 [組態集]。
在 [組態集] 頁面上，選擇要新增事件目的地的組態集。
在 [組態集詳細資料] 頁面上，選擇新增目的地事件。
在「事件詳細資料」區段下，輸入易記的「事件目的地名稱」。
從目標類型下拉菜單中選擇 Amazon 數據 Firehose。
對於IAM角色 arn，請輸入IAM角色ARN的。如需 arn IAM 角色的詳細資訊，請參閱IAMAmazon 數據 Firehose 政策。
對於交付串流 arn，請輸入要將事件傳遞到ARN的 Amazon 資料 Firehose 日誌群組。
開啟事件發佈。
在事件類型下，選擇：
- 所有SMS事件 (建議) — 選擇此選項可將中列出的所有SMS事件傳送SMS、MMS和語音的事件類型至 Amazon 資料 Firehose。
- 自訂SMS事件 — 選擇要傳送至 Amazon 資料 Firehose 的特定SMS事件。若要編輯事件清單，請選擇 [編輯SMS事件選擇]。在編輯SMS事件選擇時，只檢查您要傳送到 Amazon 資料 Firehose 的事件。選擇儲存選取範圍。
- 所有語音事件 (建議使用) — 選擇此選項可將中列出的所有語音事件傳送SMS、MMS和語音的事件類型至 Amazon Data Firehose。
- 自訂語音事件 — 選擇要傳送至 Amazon 資料 Firehose 的特定語音事件。若要編輯事件清單，請選擇 [編輯語音事件選取項目]。在編輯語音事件選擇上，只檢查您要傳送到 Amazon 資料 Firehose 的事件。選擇儲存選取範圍。
- 所有MMS事件 (建議) — 選擇此選項可將中列出的所有MMS事件傳送SMS、MMS和語音的事件類型至 Amazon 資料 Firehose。
- 自訂MMS事件 — 選擇要傳送至 Amazon 資料 Firehose 的特定MMS事件。若要編輯事件清單，請選擇 [編輯MMS事件選擇]。在編輯MMS事件選擇時，只檢查您要傳送到 Amazon 資料 Firehose 的事件。選擇儲存選取範圍。
選擇 建立事件 。

Create Amazon Data Firehose event destination (AWS CLI)

建立IAM角色和 Amazon 資料 Firehose 交付串流後，您可以建立事件目的地。

您可以使用create-event-destination指令建立事件目的地。


$ 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

在上述命令中，進行下列變更：

Replace (取代) eventDestinationName 具有描述事件目標的名稱。
Replace (取代) configurationSet 以及您要與事件目的地產生關聯的組態集名稱。
Replace (取代) eventTypes 包含中列出的一或多個事件類型SMS、MMS和語音的事件類型。
將的IamRoleArn值取代為具有中所述政策之IAM角色的 Amazon 資源名稱 (ARN) IAMAmazon 數據 Firehose 政策。
將的DeliveryStreamArn值取代為您要傳送事件ARN的 Amazon 資料 Firehose 串流。

Update Amazon Data Firehose event destination (Console)

若要使用一 AWS 般使用者簡訊SMS主控台更新 Amazon Data Firehose 事件目的地，請依照下列步驟執行：

在開啟「一 AWS 般使用者通訊SMS主控台」https://console.aws.amazon.com/sms-voice/。
在導覽窗格的 [組態] 下，選擇 [組態集]。
在 [組態集] 頁面上，選擇要新增事件目的地的組態集。
在 [組態集] 頁面上，選擇要編輯的組態集。
在組態集詳細資料頁面上，選擇 Amazon Data Firehose 事件目的地，然後選擇編輯。
對於IAM角色 arn，請輸入IAM角色ARN的。如需 arn IAM 角色的詳細資訊，請參閱IAMAmazon 數據 Firehose 政策。
對於交付串流 arn，請輸入要將事件傳遞到ARN的 Amazon 資料 Firehose 日誌群組。
在事件類型下，選擇：
- 所有SMS事件 (建議) — 選擇此選項可將中列出的所有SMS事件傳送SMS、MMS和語音的事件類型至 Amazon 資料 Firehose。
- 自訂SMS事件 — 選擇此選項，選擇要傳送的特定SMS事件 CloudWatch。若要編輯事件清單，請選擇 [編輯SMS事件選擇]。在編輯SMS事件選擇時，只檢查您要傳送到 Amazon 資料 Firehose 的事件。選擇儲存選取範圍。
- 所有語音事件 (建議使用) — 選擇此選項可將中列出的所有語音事件傳送SMS、MMS和語音的事件類型至 Amazon Data Firehose。
- 自訂語音事件 — 選擇此選項，選擇要傳送至 Amazon 資料 Firehose 的特定語音事件。若要編輯事件清單，請選擇 [編輯語音事件選取項目]。在編輯語音事件選擇上，只檢查您要傳送到 Amazon 資料 Firehose 的事件。選擇儲存選取範圍。
- 所有MMS事件 (建議) — 選擇此選項可將中列出的所有MMS事件傳送SMS、MMS和語音的事件類型至 Amazon 資料 Firehose。
- 自訂MMS事件 — 選擇此選項，選擇要傳送的特定MMS事件 CloudWatch。若要編輯事件清單，請選擇 [編輯MMS事件選擇]。在編輯MMS事件選擇時，只檢查您要傳送到 Amazon 資料 Firehose 的事件。選擇儲存選取範圍。
選擇 [編輯事件]。

Update Amazon Data Firehose event destination (AWS CLI)

您可以使用指update-event-destination令來更新事件目的地。

更新 Amazon 資料 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

在上述命令中，進行下列變更：

Replace (取代) eventDestinationName 以您要修改的事件目的地名稱。
Replace (取代) configurationSet 以及您要與事件目的地產生關聯的組態集名稱。您現在可以將事件目的地與不同組態集建立關聯。
Replace (取代) eventTypes 與中列出的其中一個事件類型SMS、MMS和語音的事件類型。
將的IamRoleArn值取代為具有中所述政策之IAM角色的 Amazon 資源名稱 (ARN) IAMAmazon 數據 Firehose 政策。
將的DeliveryStreamArn值取代為您要傳送事件ARN的 Amazon 資料 Firehose 串流。

Delete an Amazon Data Firehose event destination (Console)

不論您要刪除的事件目的地是什麼類型，刪除事件目的地的程序都相同。

在主控台中刪除 Amazon 資料 Firehose 事件目的地

在開啟「一 AWS 般使用者通訊SMS主控台」https://console.aws.amazon.com/sms-voice/。
在導覽窗格的 [組態] 下，選擇 [組態集]。
在 [組態集] 頁面上，選擇要從中移除事件目的地的組態集。
在 [所有目的地] 區段中，選擇事件目的地，然後選擇 [刪除]。

Delete an Amazon Data Firehose event destination (AWS CLI)

您可以使用delete-event-destination命令刪除事件目的地。

不論您要刪除的事件目的地是什麼類型，刪除事件目的地的程序都相同。

若要刪除 Amazon 資料 Firehose 事件目的地 AWS CLI

在命令列中執行以下命令：
```
$ aws pinpoint-sms-voice-v2 delete-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSetName
```
在上述命令中，進行下列變更：
- Replace (取代) eventDestinationName 使用要刪除的事件目標的名稱或 Amazon 資源名稱（ARN）。
- Replace (取代) configurationSetName 與事件目ARN的地相關聯的名稱或組態集。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

Amazon CloudWatch 活動目的

Amazon SNS 活動目的