本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 訂閱 Firehose 交付串流至 Amazon SNS 主題
<a name="firehose-example-subscribe-delivery-stream-to-topic"></a>

本主題說明如何為[訊息封存和分析範例使用案例](firehose-example-use-case.md)建立下列資源：
+ 允許 Amazon SNS 訂閱將記錄放置在交付串流上的 AWS Identity and Access Management (IAM) 角色。
+ Amazon SNS 主題的 Firehose 交付串流訂閱。

**為 Amazon SNS 訂閱建立 IAM 角色**

1. 開啟 IAM 主控台中的 [Roles page](https://console.aws.amazon.com/iam/home?#/roles) (角色頁面)。

1. 選擇 **建立角色**。

1. 對於 **Select type of trusted entity** (選取信任的實體類型)，選擇 **AWS service** (AWS 服務)。

1. 對於 **Choose a use case** (選擇使用案例)，選擇 **SNS**。然後選擇**下一步：許可**。

1. 選擇 **Next: Tags** (下一步：標籤)。

1. 選擇 **Next:Review (下一步：檢閱)**。

1. 在 **Review** (檢閱) 頁面，針對 **Role name** (角色名稱) 輸入 **ticketUploadStreamSubscriptionRole**。然後選擇 **Create role** (建立角色)。

1. 建立角色時，請選擇其名稱 (**ticketUploadStreamSubscriptionRole**)。

1. 在角色的 **Summary** (摘要) 頁面上，選擇 **Add inline policy** (新增內嵌政策)。

1. 在 **Create policy** (建立政策) 頁面上，選擇 **JSON** 索引標籤，然後張貼以下政策至文字方塊中：

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Action": [
                   "firehose:DescribeDeliveryStream",
                   "firehose:ListDeliveryStreams",
                   "firehose:ListTagsForDeliveryStream",
                   "firehose:PutRecord",
                   "firehose:PutRecordBatch"
               ],
               "Resource": [
                   "arn:aws:firehose:us-east-1:123456789012:deliverystream/ticketUploadStream"
               ],
               "Effect": "Allow"
           }
       ]
   }
   ```

------

   在此政策中，將 AWS 帳戶 數字 ({{123456789012}}) 取代為您自己的數字，並相應地變更 AWS 區域 ({{us-east-1}})。

1. 選擇 **Review policy** (檢閱政策)。

1. 在 **Review policy** (檢閱政策) 頁面的 **Name** (名稱) 中，輸入 **FirehoseSnsPolicy**。然後選擇 **Create policy** (建立政策)。

1. 在角色的 **Summary** (摘要) 頁面上，注意**角色 ARN** 供日後使用。

如需建立 IAM 角色的詳細資訊，請參閱《*IAM 使用者指南*》中的[建立角色以將許可委派給 AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html)。

**將 Firehose 交付串流訂閱 SNS 主題**

1. 在 Amazon SNS 主控台開啟 [Topics](https://console.aws.amazon.com/sns/home#/topics) (主題) 頁面。

1. 在 **Subscriptions** (訂閱) 索引標籤上，選擇 **Create subscription** (建立訂閱)。

1. 在**詳細資訊**下，針對**通訊協定**，選擇 ****。

1. 對於 **Endpoint** (端點)，輸入 **ticketUploadStream** 的 Amazon 資源名稱 (ARN)，您先前建立的交付串流。例如，​輸入 **arn:aws:firehose:us-east-1:123456789012:deliverystream/ticketUploadStream**。

1. 對於 **Subscription role ARN** (訂閱角色 ARN)，輸入**ticketUploadStreamSubscriptionRole** 的 ARN，您先前建立的 IAM 角色。例如，​輸入 **arn:aws:iam::123456789012:role/ticketUploadStreamSubscriptionRole**。

1. 選取 **Enable raw message delivery** (啟用原始訊息交付) 核取方塊。

1. 選擇**建立訂閱**。

您已建立 IAM 角色和 SNS 主題訂閱。若要繼續，請參閱 [測試和查詢 Amazon SNS 組態以進行有效的資料管理](firehose-example-test-and-query.md)。