在亞馬遜 Kinesis 資料串流中標記您的串流 - Amazon Kinesis Data Streams
檢閱標籤基礎使用標記追蹤成本瞭解標籤限制使用 Kinesis 資料串流主控台標記串流使用標記串流 AWS CLI使用 Kinesis 資料串流標記串流 API

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

在亞馬遜 Kinesis 資料串流中標記您的串流

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

檢閱標籤基礎

您可以使用 Kinesis Data Streams 主控台， AWS CLI或 Kinesis Data Streams API 來完成下列工作：

  • 使用標籤建立串流

  • 為串流新增標籤

  • 列出串流的標籤

  • 從串流移除標籤

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

  • 專案：專案名稱

  • 擁有者：名稱

  • 用途：負載測試

  • 應用程式：應用程式名稱

  • 環境：生產

使用標記追蹤成本

您可以使用標籤來分類和跟踪您的 AWS 成本。當您將標籤套用至 AWS 資源，包括串流、您的 AWS 成本分配報表包括使用量和按標籤彙總的成本。您可以套用代表業務類別 (例如成本中心、應用程式名稱或擁有者) 的標籤，來整理多個服務中的成本。如需詳細資訊，請參閱「針對自訂帳單報表使用成本分配標籤」。AWS Billing 用戶指南。

瞭解標籤限制

下列限制適用於標籤。

基本限制

  • 每項資源 (串流) 的標籤數上限為 50。

  • 標籤金鑰與值皆區分大小寫。

  • 您無法變更或編輯已刪除串流的標籤。

標籤鍵限制

  • 每個標籤鍵都必須是唯一的。如果您新增具有已使用金鑰的標籤，則新的標籤會覆寫現有金鑰值對。

  • 您不能以標籤鍵開頭，aws:因為此前綴保留供使用 AWS. AWS 代表您建立以此首碼開頭的標籤，但您無法編輯或刪除它們。

  • 標籤鍵的長度必須介於 1 到 128 個 Unicode 字元之間。

  • 標籤鍵必須包含下列字元：Unicode 字母、數字、空格以及下列特殊字元：_ . / = + - @。

標籤值限制

  • 標籤值的長度必須介於 0 到 255 個 Unicode 字元之間。

  • 標籤值可以空白。否則，它們必須包含下列字元：Unicode 字母、數字、空格以及下列任何特殊字元：_ . / = + - @。

使用 Kinesis 資料串流主控台標記串流

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

檢視串流的標籤

  1. 開啟 Kinesis Data Streams 主控台。在導覽列中，展開「區域」選取器並選取「區域」。

  2. 在 Stream List (串流清單) 頁面上，選取任一串流。

  3. 在 [串流詳細資料] 頁面上，選擇 [標記] 索引標籤

使用標籤建立資料串流

  1. 開啟 Kinesis Data Streams 主控台。在導覽列中，展開「區域」選取器並選取「區域」。

  2. 選擇 [建立直播]。

  3. 在 [建立資料串流] 頁面上，輸入資料串流的名稱，然後選擇隨選或佈建容量模式。依預設，會選取隨需模式。如需詳細資訊，請參閱選擇資料串流容量模式。

  4. 在 標籤 區域，選擇 新增。在「關鍵字」欄位中指定標籤，並選擇性地在「值」欄位中指定值。

    如果看到錯誤，表示您指定的標籤鍵或值不符合標籤限制。如需詳細資訊，請參閱瞭解標籤限制。

  5. 選擇 建立資料串流。

  6. 在 [資料串流] 頁面上，串流的 [狀態] 會在建立串流時顯示為 [建立]。當串流已準備就緒可供使用時，狀態會變更為 [作用中]。

  7. 選擇串流名稱。串流詳細資訊頁面會顯示串流組態的摘要以及監控資訊。

為串流新增標籤

  1. 開啟 Kinesis Data Streams 主控台。在導覽列中，展開「區域」選取器並選取「區域」。

  2. 在 Stream List (串流清單) 頁面上，選取任一串流。

  3. 在 [串流詳細資料] 頁面上，選擇 [標記] 索引標籤

  4. 在「主鍵」欄位中指定標籤鍵，選擇性地在「值」欄位中指定標籤值，然後選擇「新增標籤」。

    如果未啟用 Add Tag (新增標籤) 按鈕，則表示您所指定的標籤鍵或標籤值不符合標籤限制。如需詳細資訊，請參閱瞭解標籤限制。

  5. 若要在「標籤」標籤的清單中檢視新標籤，請選擇重新整理圖示。

從串流移除標籤

  1. 開啟 Kinesis Data Streams 主控台。在導覽列中，展開「區域」選取器並選取「區域」。

  2. 在 Stream List (串流清單) 頁面上，選取任一串流。

  3. 在 [串流詳細資料] 頁面上，選擇 [標記] 索引標籤，然後選擇標記的 [移除] 圖示。

  4. 在「刪除標籤」對話方塊中，選擇「是，刪除」。

使用標記串流 AWS CLI

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

創建流

創建帶有標籤的流。

add-tags-to-stream

為指定的串流新增或更新標籤。

list-tags-for-stream

列出所指定串流的標籤。

remove-tags-from-stream

從指定的串流移除標籤。

使用 Kinesis 資料串流標記串流 API

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

CreateStream

創建帶有標籤的流。

AddTagsToStream

為指定的串流新增或更新標籤。

ListTagsForStream

列出所指定串流的標籤。

RemoveTagsFromStream

從指定的串流移除標籤。