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

# 標記您的 Amazon Kinesis Data Streams 資源
<a name="tagging"></a>

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

**Topics**
+ [檢閱標籤基本概念](#tagging-basics)
+ [使用標記追蹤成本](#tagging-billing)
+ [了解標籤限制](#tagging-restrictions)
+ [使用 Kinesis Data Streams 主控台標記串流](#tagging-console)
+ [使用 標記串流 AWS CLI](#tagging-cli)
+ [使用 Kinesis Data Streams APIs 標記串流](#tagging-api)
+ [使用 標記消費者 AWS CLI](#tagging-consumers-cli)
+ [使用 Kinesis Data Streams APIs 標記消費者](#tagging-consumers-api)

## 檢閱標籤基本概念
<a name="tagging-basics"></a>

您可以標記的 Kinesis Data Streams 資源包括資料串流和增強廣發消費者。您可以使用 Kinesis Data Streams 主控台 AWS CLI或 Kinesis Data Streams API 來完成下列任務：
+ 使用標籤建立資源
+ 將標籤新增至資源
+ 列出資源的標籤
+ 從資源移除標籤

**注意**  
您無法使用 Kinesis Data Streams 主控台將標籤套用至增強型廣發消費者。若要將標籤套用至消費者，請使用 AWS CLI 或 Kinesis Data Streams API。

您可以使用標籤來分類您的 資源。例如，您可以依用途、擁有者或環境來分類資源。由於您定義了每個標籤的鍵和值，您可以建立一組自訂的類別，以符合您的特定需求。例如，您可以定義一組標籤，協助您依擁有者和相關聯的應用程式追蹤資源。以下是數個標籤的範例：
+ 專案：專案名稱
+ 擁有者：名稱
+ 用途：負載測試 
+ 應用程式：應用程式名稱
+ 環境：生產 

**重要**  
若要在建立串流時新增標籤，您必須包含該串流的 `kinesis:CreateStream`和 `kinesis:AddTagsToStream`許可。建立串流時**，您無法使用** `kinesis:TagResource`許可來標記串流。
若要在消費者註冊期間新增標籤，您必須包含 `kinesis:TagResource`和 `kinesis:RegisterStreamConsumer`許可。

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

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

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

以下限制適用於標籤：

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

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

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

## 使用 Kinesis Data Streams 主控台標記串流
<a name="tagging-console"></a>

您可以使用 Kinesis Data Streams 主控台新增、更新、列出和移除串流上的標籤。

**檢視串流的標籤**

1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/kinesis](https://console.aws.amazon.com/kinesis) 的 Kinesis 主控台。

1. 在左側導覽窗格中，選擇**資料串流**。

1. 在**資料串流**頁面上，選擇您要標記的串流。

1. 在串流詳細資訊頁面上，選擇**組態**。

1. 在**標籤**區段中，檢視套用至串流的標籤。

**使用標籤建立資料串流**

1. 開啟 Kinesis Data Streams 主控台。

1. 在左側導覽窗格中，選擇**資料串流**。

1. 選擇 **建立資料串流**。

1. 在**建立資料串流**頁面上，輸入資料串流的名稱。

1. 針對**資料串流容量**，選擇**隨需**或**佈建**容量模式。

   如需容量模式的詳細資訊，請參閱 [選擇要在 中串流的正確模式](how-do-i-size-a-stream.md)。

1. 在**標籤**區段中，執行下列動作：

   1. 選擇 **Add new tag (新增標籤)**。

   1. 針對**金鑰**，輸入標籤，並選擇性地在值欄位中指定**值**。

      如果您看到錯誤，您指定的標籤索引鍵或值不符合標籤限制。如需詳細資訊，請參閱[了解標籤限制](#tagging-restrictions)。

1. 選擇 **建立資料串流**。

**在串流上新增或更新標籤**

1. 開啟 Kinesis Data Streams 主控台。

1. 在左側導覽窗格中，選擇**資料串流**。

1. 在**資料串流**頁面上，選擇要新增或更新標籤的串流。

1. 在串流詳細資訊頁面上，選擇**組態**。

1. 在**標籤**區段中，選擇**管理標籤**。

1. 在**標籤**下，執行下列其中一項操作：
   + 若要新增標籤，請選擇**新增標籤**，然後輸入標籤的**金鑰**和**值**資料。視需要重複此步驟。

     您可以為每個串流新增的標籤數量上限為 50。
   + 若要更新現有的標籤，請在該標籤**金鑰****的值**欄位中輸入新的標籤值。

   如果您看到錯誤，您指定的標籤索引鍵或值不符合標籤限制。如需詳細資訊，請參閱[了解標籤限制](#tagging-restrictions)。

1. 選擇 **Save changes** (儲存變更)。

**從串流移除標籤**

1. 開啟 Kinesis Data Streams 主控台。

1. 在左側導覽窗格中，選擇**資料串流**。

1. 在**資料串流**頁面上，選擇要從中移除標籤的串流。

1. 在串流詳細資訊頁面上，選擇**組態**。

1. 在**標籤**區段中，選擇**管理標籤**。

1. 尋找您要移除的標籤**索引鍵**和**值**對。然後選擇**移除**。

1. 選擇**儲存變更**。

## 使用 標記串流 AWS CLI
<a name="tagging-cli"></a>

您可以使用 新增、列出和移除串流上的標籤 AWS CLI。如需範例，請參閱下列文件。

 [create-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/create-stream.html)   
建立具有標籤的串流。

 [add-tags-to-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/add-tags-to-stream.html)   
為指定的串流新增或更新標籤。

 [list-tags-for-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/list-tags-for-stream.html)  
列出所指定串流的標籤。

 [remove-tags-from-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/remove-tags-from-stream.html)  
從指定的串流移除標籤。

## 使用 Kinesis Data Streams APIs 標記串流
<a name="tagging-api"></a>

您可以使用 Kinesis Data Streams APIs 在串流上新增、列出和移除標籤。如需範例，請參閱下列文件：

 [CreateStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_CreateStream.html)   
建立具有標籤的串流。

 [AddTagsToStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_AddTagsToStream.html)   
為指定的串流新增或更新標籤。

 [ListTagsForStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_ListTagsForStream.html)  
列出所指定串流的標籤。

 [RemoveTagsFromStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_RemoveTagsFromStream.html)  
從指定的串流移除標籤。

## 使用 標記消費者 AWS CLI
<a name="tagging-consumers-cli"></a>

您可以使用 新增、列出和移除消費者上的標籤 AWS CLI。如需範例，請參閱下列文件：

[register-stream-consumer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/register-stream-consumer.html)  
使用標籤註冊 Kinesis 資料串流的取用者。

[tag-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/tag-resource.html)  
新增或更新指定 Kinesis 資源的標籤。

[list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/list-tags-for-resource.html)  
列出指定 Kinesis 資源的標籤。

[untag-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/untag-resource.html)  
從指定的 Kinesis 資源移除標籤。

## 使用 Kinesis Data Streams APIs 標記消費者
<a name="tagging-consumers-api"></a>

您可以使用 Kinesis Data Streams APIs 在消費者上新增、列出和移除標籤。如需範例，請參閱下列文件：

[RegisterStreamConsumer](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_RegisterStreamConsumer.html)  
使用標籤註冊 Kinesis 資料串流的取用者。

[TagResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_TagResource.html)  
新增或更新指定 Kinesis 資源的標籤。

[ListTagsForResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_ListTagsForResource.html)  
列出指定 Kinesis 資源的標籤。

[UntagResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_UntagResource.html)  
從指定的 Kinesis 資源移除標籤。