本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
您可以使用標籤的形式,對您在 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 Data Streams 主控台標記串流
您可以使用 Kinesis Data Streams 主控台新增、列出和移除標籤。
檢視串流的標籤
-
開啟 Kinesis Data Streams 主控台。在導覽列中,展開區域選擇器,然後選取區域。
-
在 Stream List (串流清單) 頁面上,選取任一串流。
-
在串流詳細資訊頁面上,選擇標籤索引標籤。
使用標籤建立資料串流
-
開啟 Kinesis Data Streams 主控台。在導覽列中,展開區域選擇器,然後選取區域。
-
選擇建立串流。
-
在建立資料串流頁面上,輸入資料串流的名稱,然後選擇隨需或佈建容量模式。依預設,會選取隨需模式。如需詳細資訊,請參閱選擇資料串流容量模式。
-
在 標籤 區域,選擇 新增。在金鑰欄位中指定標籤,並選擇性地在值欄位中指定值。
如果您看到錯誤,您指定的標籤索引鍵或值不符合標籤限制。如需詳細資訊,請參閱了解標籤限制。
-
選擇 建立資料串流。
-
在資料串流頁面上,串流的狀態會在建立串流時顯示為建立。當串流可供使用時,狀態會變更為作用中。
-
選擇串流名稱。串流詳細資訊頁面會顯示串流組態的摘要以及監控資訊。
為串流新增標籤
-
開啟 Kinesis Data Streams 主控台。在導覽列中,展開區域選擇器,然後選取區域。
-
在 Stream List (串流清單) 頁面上,選取任一串流。
-
在串流詳細資訊頁面上,選擇標籤索引標籤。
-
在金鑰欄位中指定標籤金鑰,選擇性地在值欄位中指定標籤值,然後選擇新增標籤。
如果未啟用 Add Tag (新增標籤) 按鈕,則表示您所指定的標籤鍵或標籤值不符合標籤限制。如需詳細資訊,請參閱了解標籤限制。
-
若要在標籤索引標籤的清單中檢視您的新標籤,請選擇重新整理圖示。
從串流移除標籤
-
開啟 Kinesis Data Streams 主控台。在導覽列中,展開區域選擇器,然後選取區域。
-
在 Stream List (串流清單) 頁面上,選取任一串流。
-
在串流詳細資訊頁面上,選擇標籤索引標籤,然後選擇標籤的移除圖示。
-
在刪除標籤對話方塊中,選擇是、刪除。
使用 標記串流 AWS CLI
您可以使用 AWS CLI來新增、列出和移除標籤。如需範例,請參閱下列文件。
- create-stream
-
使用標籤建立串流。
- add-tags-to-stream
-
為指定的串流新增或更新標籤。
- list-tags-for-stream
-
列出所指定串流的標籤。
- remove-tags-from-stream
-
從指定的串流移除標籤。
使用 Kinesis Data Streams API 標記串流
您可以使用 Kinesis Data Streams API 新增、列出和移除標籤。如需範例,請參閱下列文件:
- CreateStream
-
使用標籤建立串流。
- AddTagsToStream
-
為指定的串流新增或更新標籤。
- ListTagsForStream
-
列出所指定串流的標籤。
- RemoveTagsFromStream
-
從指定的串流移除標籤。