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

# 標記 Firehose 串流
<a name="firehose-tagging"></a>

您可以將自己的中繼資料以*標籤*形式指派給您在 Amazon Data Firehose 中建立的 Firehose 串流。標籤是您為串流所定義的索引鍵值組。使用標籤是一種簡單但強大的方法來管理 AWS 資源和組織資料，包括帳單資料。

您可以在叫用 [CreateDeliveryStream](https://docs.aws.amazon.com/firehose/latest/APIReference/API_CreateDeliveryStream.html) 建立新的 Firehose 串流時指定標籤。對於現有的 Firehose 串流，您可以使用下列三個操作來新增、列出和移除標籤：
+ [TagDeliveryStream](https://docs.aws.amazon.com/firehose/latest/APIReference/API_TagDeliveryStream.html)
+ [ListTagsForDeliveryStream](https://docs.aws.amazon.com/firehose/latest/APIReference/API_ListTagsForDeliveryStream.html)
+ [UntagDeliveryStream](https://docs.aws.amazon.com/firehose/latest/APIReference/API_UntagDeliveryStream.html)

# 了解標籤基本概念
<a name="firehose-tagging-basics"></a>

您可以使用 Amazon Data Firehose API 操作來完成下列任務：
+ 將標籤新增至 Firehose 串流。
+ 列出 Firehose 串流的標籤。
+ 從 Firehose 串流移除標籤。

您可以使用標籤來分類 Firehose 串流。例如，您可以依用途、擁有者或環境來分類 Firehose 串流。由於您定義了每個標籤的鍵和值，您可以建立一組自訂的類別，以符合您的特定需求。例如，您可以定義一組標籤，協助您依擁有者和相關聯的應用程式追蹤 Firehose 串流。

下列為數個標籤的範例：
+ `Project: Project name`
+ `Owner: Name`
+ `Purpose: Load testing` 
+ `Application: Application name`
+ `Environment: Production` 

如果您在`CreateDeliveryStream`動作中指定標籤，Amazon Data Firehose 會對`firehose:TagDeliveryStream`動作執行額外的授權，以驗證使用者是否具有建立標籤的許可。如果您未提供此許可，使用 IAM 資源標籤建立新 Firehose 串流的請求會失敗，`AccessDeniedException`如下所示。

```
AccessDeniedException 
User: arn:aws:sts::x:assumed-role/x/x is not authorized to perform: firehose:TagDeliveryStream on resource: arn:aws:firehose:us-east-1:x:deliverystream/x with an explicit deny in an identity-based policy.
```

下列範例示範允許使用者建立 Firehose 串流並套用標籤的政策。

# 使用標記追蹤成本
<a name="firehose-tagging-billing"></a>

您可以使用標籤來分類和追蹤您的 AWS 成本。當您將標籤套用至資源 AWS 時，包括 Firehose 串流， AWS 成本分配報告會包含依標籤彙總的用量和成本。套用代表商業類別的標籤 (例如成本中心、應用程式名稱或擁有者)，即可整理多個服務的成本。如需詳細資訊，請參閱《AWS Billing 使用者指南**》中的[將成本分配標籤用於自訂帳單報告](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。

# 了解標籤限制
<a name="firehose-tagging-restrictions"></a>

下列限制適用於 Amazon Data Firehose 中的標籤。

**基本限制**
+ 每項資源 (串流) 的標籤數上限為 50。
+ 標籤鍵與值皆區分大小寫。
+ 您無法變更或編輯已刪除串流的標籤。

**標籤鍵限制**
+ 每個標籤鍵都必須是唯一的。如果您新增具有已使用索引鍵的標籤，則新的標籤會覆寫現有鍵值對。
+ 標籤金鑰開頭不能為 `aws:`，因為此字首保留供 AWS使用。 AWS 會代表您建立開頭為此字首的標籤，但您無法加以編輯或刪除。
+ 標籤鍵的長度必須介於 1 到 128 個 Unicode 字元之間。
+ 標籤鍵必須包含下列字元：Unicode 字母、數字、空格以及下列特殊字元：`_ . / = + - @`。

**標籤值限制**
+ 標籤值的長度必須介於 0 到 255 個 Unicode 字元之間。
+ 標籤值可以空白。否則，它們必須包含下列字元：Unicode 字母、數字、空格以及下列任何特殊字元：`_ . / = + - @`。