**協助改進此頁面**
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
若要為本使用者指南貢獻內容，請點選每個頁面右側面板中的**在 GitHub 上編輯此頁面**連結。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用標籤組織 Amazon EKS 資源
您可以使用*標籤*協助您管理 Amazon EKS 資源。本主題提供標籤功能的概觀，並展示您如何建立標籤。
**Topics**
+ [標籤基本概念](#tag-basics)
+ [標記您的 資源](#tag-resources)
+ [標籤限制](#tag-restrictions)
+ [標記您的資源以便計費](#tag-resources-for-billing)
+ [透過主控台使用標籤](#tag-resources-console)
+ [透過 CLI、API 或 `eksctl` 使用標籤](#tag-resources-api-sdk)
**注意**
標籤是一種與 Kubernetes 標籤和註釋分開的中繼資料類型。如需有關這些其他中繼資料類型的詳細資訊，請參閱 Kubernetes 文件中的下列章節：
[標籤和選取器](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/)
[註釋](https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/)
## 標籤基本概念
標籤是您指派給 AWS 資源的標籤。每個標籤皆包含*索引鍵*與選用*值*。
您可以使用標籤將的 AWS 資源分類。例如，您可以依用途、擁有者或環境來分類資源。當您有許多相同類型的資源時，您可以依據先前指派給特定資源的標籤來快速識別該資源。例如，您可以為 Amazon EKS 叢集定義一組標籤，協助您追蹤每個叢集的擁有者和堆疊層級。建議您為每個資源類型設計一組一致的標籤索引鍵。然後，就可以根據您新增的標籤來搜尋和篩選資源。
新增標籤後，您可以隨時編輯標籤索引鍵和值，或從資源移除標籤。如果您刪除資源，也會刪除任何該資源的標籤。
標籤對 Amazon EKS 來說不具有任何語意意義，並會嚴格解譯為字元字串。您可以將標籤的值設為空白字串。不過，您無法將標籤的值設為 null。若您將與現有標籤具有相同鍵的標籤新增到該資源，則新值會覆寫早前的值。
如果使用 AWS Identity and Access Management (IAM)，您可以控制您的 AWS 帳戶中的哪些使用者具有管理標籤的許可。
## 標記您的 資源
以下 Amazon EKS 資源支援標籤：
+ 叢集
+ 受管節點群組
+ Fargate 描述檔
您可以使用以下項目標記這些資源：
+ 如果使用 Amazon EKS 主控台，則可以隨時將標籤套用到新資源或現有資源。您可以在相關資源頁面使用 **Tags** (標籤) 索引標籤進行此操作。如需詳細資訊，請參閱 [透過主控台使用標籤](#tag-resources-console)。
+ 如果使用 `eksctl`，則可以在使用 `--tags` 選項建立時將標籤套用到資源。
+ 如果使用 AWS CLI、Amazon EKS API 或 AWS SDK，則可以在相關 API 動作上使用 `tags` 參數，將標籤套用到新資源。您也可以使用 `TagResource` API 動作將標籤套用到現有資源。如需詳細資訊，請參閱 [TagResource](https://docs.aws.amazon.com/eks/latest/APIReference/API_TagResource.html)。
當您使用某些資源建立動作時，您也可以在建立資源的同時為資源指定標籤。如果在建立資源時無法套用標籤，則無法建立資源。此機制可確保您要標記的資源是以您指定的標籤建立，不然就根本不會建立。如果您在建立資源時將其標記，則不需要在建立資源之後執行自訂標記指令碼。
標籤不會傳播到與您建立的資源相關聯的其他資源。例如，Fargate 設定檔標籤不會傳播到與 Fargate 設定檔相關聯的其他資源，例如與設定檔一起排程的 Pod。
## 標籤限制
以下限制適用於標籤：
+ 資源最多可與 50 個標籤建立關聯。
+ 一個資源的標籤索引鍵不能重複。每個標籤索引鍵都必須是唯一的，而且只能有一個值。
+ 索引鍵的長度上限是 128 個 UTF-8 字元。
+ 索引鍵的長度上限是 256 個 UTF-8 字元。
+ 如果多個 AWS 服務和資源使用您的標記結構描述，請限制您使用的字元類型。某些服務可能對允許的字元設有限制。通常允許的字元為：字母、數字和空格，以及下列字元：`+` `-` `=` `.` `_` `:` `/` `@`。
+ 標籤鍵與值皆區分大小寫。
+ 不使用 `aws:`、` AWS:` 或任何大小寫組合作為索引鍵或值的字首。因為它預訂給 AWS 使用。您不可編輯或刪除具有此字首的標籤索引鍵或值。具有此字首的標籤不算在每一資源的標籤數限制內。
## 標記您的資源以便計費
當您將標籤套用到 Amazon EKS 叢集時，您可以在**成本與用量報告**中使用標籤來分配成本。**成本與用量報告**中的計量資料會顯示所有 Amazon ECS 叢集的用量。如需詳細資訊，請參閱《*AWS 帳單使用者指南*》中的 [AWS 成本與用量報告](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-reports-costusage.html)。
AWS 產生的成本配置標籤，尤其是 `aws:eks:cluster-name`，可讓您依 **Cost Explorer** 中的個別 Amazon EKS 叢集列出 Amazon EC2 執行個體成本明細。但是，此標籤不會擷取控制平面費用。標籤會自動新增至參與 Amazon EKS 叢集的 Amazon EC2 執行個體中。無論執行個體是使用 Amazon EKS 受管節點群組、Karpenter 或直接使用 Amazon EC2 佈建，都會發生此行為。此特定標籤不會計入 50 個標籤限制。若要使用標籤，帳戶擁有者必須在 AWS 帳單主控台中啟用該標籤，或使用 API 啟用。若 AWS Organizations 管理帳戶擁有者啟用此標籤，也會針對所有組織會員帳戶啟用該標籤。
您也可以根據具有相同標籤索引鍵值的資源來整理您的帳單資訊。例如，您可以使用特定應用程式名稱來標記數個資源，然後整理帳單資訊。這樣一來，您就可以查看該應用程式跨數項服務的總成本。如需有關使用標籤設定成本分配報告的詳細資訊，請參閱《*AWS 帳單使用者指南*》中的[每月成本分配報告](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html)。
**注意**
如果您剛啟用報告，當月資料會在 24 小時之後提供檢視。
**Cost Explorer** 是可作為 AWS 免費方案的一部分使用的報告工具。您可以使用 **Cost Explorer** 檢視過去 13 個月的 Amazon EKS 資源圖表。您還可以預測未來三個月可能花費的金額。您可以查看在一段時間內的 AWS 資源支出模式。例如，您可以用它來找出需進一步調查的領域，以及查看您可用來了解成本的趨勢。您也可以指定資料的時間範圍，以及根據天或月檢視時間資料。
## 透過主控台使用標籤
您可以使用 Amazon EKS 主控台，管理與新的或現有的叢集和受管節點群組相關聯的標籤。
當您在 Amazon EKS 主控台中選取資源限定頁面時，該頁面會顯示那些資源的清單。例如，若您從左側導航窗格選取 **Clusters** (叢集)，主控台會顯示 Amazon EKS 叢集的清單。當您從支援標籤的其中一個清單選取資源時 (例如，特定的叢集)，您便可以在 **Tags** (標籤) 索引標籤上檢視和管理其標籤。
您也可以使用 AWS 管理主控台 中的 **Tag Editor** (標籤編輯器)，其提供了一種統一的方法來管理標籤。如需詳細資訊，請參閱《*AWS 標籤編輯器使用者指南*》中的[使用標籤編輯器標記您的 AWS 資源](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html)。
### 在建立資源時新增標籤
在建立 Amazon EKS 叢集、受管節點群組和 Fargate 描述檔時，您可以將標籤新增至其中。如需詳細資訊，請參閱 [建立 Amazon EKS 叢集](create-cluster.md)。
### 在資源上新增和刪除標籤
您可以直接從資源的頁面新增或刪除與叢集相關聯的標籤。
1. 開啟 [Amazon EKS 主控台](https://console.aws.amazon.com/eks/home#/clusters)。
1. 在導覽列中，選取要使用的 AWS 區域。
1. 在左側導覽窗格中選擇**叢集**。
1. 選擇特定叢集。
1. 選擇 **Tags** (標籤) 索引標籤，然後選擇 **Manage tags** (管理標籤)。
1. 在 **Manage tags** (管理標籤) 頁面上，視需要新增或刪除標籤。
+ 若要新增標籤，請選擇 **Add tag (新增標籤)**。然後指定每個標籤的索引鍵和值。
+ 若要移除標籤，請選擇 **Remove tag** (移除標籤)。
1. 針對您要新增或刪除的每個標籤重複此程序。
1. 選擇 **Update (更新)** 以完成操作。
## 透過 CLI、API 或 `eksctl` 使用標籤
使用下列 AWS CLI 命令或 Amazon EKS API 操作來新增、更新、列出及刪除資源的標籤。您只能使用 `eksctl` 新增標籤，同時使用一個命令建立新資源。
| 任務 | AWS CLI | AWS Tools for Windows PowerShell | API 動作 |
| --- | --- | --- | --- |
| 新增或覆寫一或多個標籤。 | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/eks/tag-resource.html) | [Add-EKSResourceTag](https://docs.aws.amazon.com/powershell/latest/reference/items/Add-EKSResourceTag.html) | [TagResource](https://docs.aws.amazon.com/eks/latest/APIReference/API_TagResource.html) |
| 刪除一或多個標籤。 | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/eks/untag-resource.html) | [Remove-EKSResourceTag](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EKSResourceTag.html) | [UntagResource](https://docs.aws.amazon.com/eks/latest/APIReference/API_UntagResource.html) |
下列範例示範如何使用 AWS CLI 來標記或取消標記資源。
**範例 1：標記現有的叢集**
以下命令標記現有的叢集。
```
aws eks tag-resource --resource-arn resource_ARN --tags team=devs
```
**範例 2：取消標記現有的叢集**
以下命令從現有的叢集刪除標籤。
```
aws eks untag-resource --resource-arn resource_ARN --tag-keys tag_key
```
**範例 3：列出資源的標籤**
以下命令列出與現有資源相關聯的標籤。
```
aws eks list-tags-for-resource --resource-arn resource_ARN
```
當您使用某些資源建立動作時，您可以在建立資源的同時指定標籤。下列動作支援在建立資源時指定標籤。
| 任務 | AWS CLI | AWS Tools for Windows PowerShell | API 動作 | eksctl |
| --- | --- | --- | --- | --- |
| 建立叢集 | [create-cluster](https://docs.aws.amazon.com/cli/latest/reference/eks/create-cluster.html) | [New-EKSCluster](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EKSCluster.html) | [CreateCluster](https://docs.aws.amazon.com/eks/latest/APIReference/API_CreateCluster.html) | `create cluster` |
| 建立受管節點群組\$1 | [create-nodegroup](https://docs.aws.amazon.com/cli/latest/reference/eks/create-nodegroup.html) | [New-EKSNodegroup](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EKSNodegroup.html) | [CreateNodegroup](https://docs.aws.amazon.com/eks/latest/APIReference/API_CreateNodegroup.html) | `create nodegroup` |
| 建立 Fargate 設定檔 | [create-fargate-profile](https://docs.aws.amazon.com/cli/latest/reference/eks/create-fargate-profile.html) | [New-EKSFargateProfile](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EKSFargateProfile.html) | [CreateFargateProfile.html](https://docs.aws.amazon.com/eks/latest/APIReference/API_CreateFargateProfile.html) | `create fargateprofile` |
+ 如果還想在建立受管節點群組時為 Amazon EC2 執行個體加上標籤，請使用啟動範本建立受管節點群組。如需詳細資訊，請參閱 [標記 Amazon EC2 執行個體](launch-templates.md#launch-template-tagging)。如果您的執行個體已經存在，則可以手動為執行個體加上標籤。如需詳細資訊，請參閱《Amazon EC2 使用者指南》中的[標記您的資源](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-resources)。