標記 Athena 資源

焦點模式

標記 Athena 資源 - Amazon 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 動作中使用現有的標籤鍵來標記資源，新標籤值會覆寫舊值。
標籤索引鍵長度為 1-128 個 UTF-8 Unicode 字元。
標籤值長度為 0-256 個 UTF-8 Unicode 字元。

您需要指定工作群組資源的 ARN，才能執行標記操作，例如新增、編輯、移除或列出標籤。
Athena 可讓您使用字母、數字、以 UTF-8 表示的空格，以及下列字元：+ – = . _ : / @。
標籤金鑰與值皆區分大小寫。
標籤索引鍵中的"aws:"字首會保留供 AWS 使用。您無法編輯或刪除含有此字首的標籤索引鍵。含有此字首的標籤不算在每一資源的標籤限制內。
您指派的標籤僅供 Amazon Web Services 帳戶使用。