標籤 Athena 資源 - Amazon Athena
標籤基本概念標籤限制

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

標籤 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 帳戶使用。