本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
標籤 Athena 資源
每個標記皆包含由您定義的金鑰和值。標記 Athena 資源時,您可以將自訂中繼資料指派給該資源。您可以使用標籤以不同方式分類 AWS 資源,例如依用途、擁有者或環境。在 Athena 中,工作群組、資料目錄和容量保留等資源都是可標記的資源。例如,您可以為帳戶中的工作群組建立一組標籤,以協助您追蹤工作群組擁有者,或依用途來識別工作群組。如果您也在 Billing and Cost Management 主控台中啟用標籤作為成本分配標籤,則與執行查詢相關聯的成本會顯示在「成本和用量報告」中,並含有該成本分配標籤。我們建議您使用 AWS 標記最佳實務來建立一組一致的標籤,以滿足您組織的需求。
您可以使用 Athena 主控台或作API業來處理標籤。
標籤基本概念
標籤是您指派給 Athena 資源的標籤。每個標籤皆包含由您定義的一個金鑰與一個選用值。
標籤可讓您以不同的方式對資 AWS 源進行分類。例如,您可以為您帳戶的工作群組定義一組標籤,以協助您追蹤每個工作群組擁有者或用途。
您可以在建立新的 Athena 工作群組或資料目錄時新增標籤,或從中新增、編輯或移除標籤。您可以在主控台編輯標籤。若要使用API操作編輯標籤,請移除舊標籤並新增標籤。如果您刪除資源,也會刪除任何該資源的標籤。
Athena 不會自動為您的資源指派標籤。您可以編輯標籤金鑰和值,並且可以隨時從資源移除標籤。您可以將標籤的值設為空白字串,但您無法將標籤的值設為 Null。請勿將重複的標籤鍵新增至相同的資源。如果這樣做,Athena 會發出錯誤訊息。如果您使用 TagResource 動作來標記使用現有標籤鍵的資源,則新標籤值會覆寫舊值。
在中IAM,您可以控制 Amazon Web Services 帳戶中哪些使用者有權建立、編輯、移除或列出標籤。如需詳細資訊,請參閱使用標籤式IAM存取控制原則。
如需 Amazon Athena 標籤動作的完整清單,請參閱 Amazon Athena API 參考中的API動作名稱。
您可以使用標籤來計費。如需詳細資訊,請參閱《AWS Billing and Cost Management 使用者指南》中的使用標籤計費。
如需詳細資訊,請參閱標籤限制。
標籤限制
標籤有以下限制:
-
在 Athena 中,您可以標記工作群組和資料目錄。您無法標記查詢。
-
每一資源標籤數最多為 50。若要保持在限制內,請檢閱和刪除未使用的標籤。
-
對於每一個資源,每個標籤金鑰必須是唯一的,且每個標籤金鑰只能有一個值。請勿將重複的標籤鍵同時新增到相同的工作群組。如果這樣做,Athena 會發出錯誤訊息。如果您在個別的
TagResource
動作中使用現有的標籤鍵來標記資源,新標籤值會覆寫舊值。 -
標籤密鑰長度為 UTF -8 中 1-128 個萬國碼字符。
-
標籤值長度為 UTF -8 中的 0-256 個萬國碼字元。
標籤作業 (例如新增、編輯、移除或列示標籤) 需要您為工作群組資源指定一個ARN。
-
Athena 允許您使用字母、數字、UTF -8 表示的空格,以及下列字元:+-=. _:/@。
-
標籤金鑰與值皆區分大小寫。
-
標籤鍵中的
"aws:"
前綴保留供 AWS 使用。您無法編輯或刪除含有此字首的標籤索引鍵。含有此字首的標籤不算在每一資源的標籤限制內。 -
您指派的標籤僅供 Amazon Web Services 帳戶使用。