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

為您的 Amazon EMR on EKS 資源加上標籤

為協助您管理 Amazon EMR on EKS 資源，可以使用標籤將您自己的中繼資料指派給每個資源。本主題提供標籤功能的概觀，並展示如何建立標籤。

標籤基本概念

標籤是您指派給 AWS 資源的標籤。每個標籤皆包含由您定義的一個金鑰與一個選用值。

標籤允許您按照屬性將 AWS 資源分類，例如目的、擁有者或環境。當您有許多相同類型的資源時，您可以依據先前指派的標籤，快速識別特定的資源。例如，您可以為 Amazon EMR on EKS 叢集定義一組標籤，協助您追蹤每個叢集的擁有者和堆疊層級。建議您為每個資源類型設計一組一致的標籤金鑰。然後，就可以根據您新增的標籤來搜尋和篩選資源。

標籤不會自動指派給您的資源。新增標籤後，您可以隨時編輯標籤索引鍵和值，或從資源移除標籤。如果您刪除資源，也會刪除任何該資源的標籤。

標籤對 Amazon EMR on EKS 來說不具有任何語意意義，並會嚴格解譯為字元字串。

標籤值可以為空白字串，但不得是 null。標籤金鑰不得為空白字串。若您將與現有標籤具有相同鍵的標籤新增到該資源，則新值會覆寫早前的值。

如果使用 AWS Identity and Access Management (IAM)，您可以控制您的 AWS 帳戶中的哪些使用者具有管理標籤的許可。

如需標籤型存取控制政策範例，請參閱 標籤型存取控制政策。

標記您的 資源

可以為新的或現有的虛擬叢集以及處於使用中狀態的作業執行加上標籤。作業執行的作用中狀態包括：PENDING、SUBMITTED、RUNNING 和 CANCEL_PENDING。虛擬叢集的作用中狀態包括：RUNNING、TERMINATING 和 ARRESTED。如需詳細資訊，請參閱作業執行狀態及虛擬叢集狀態。

當虛擬叢集終止時，會清除標籤且無法再存取。

如果使用 Amazon EMR on EKS API、AWS CLI 或 AWS SDK，則可以使用相關 API 動作中的標籤參數，將標籤套用到新資源。您也可以使用 TagResource API 動作將標籤套用到現有資源。

在建立資源時，可以使用一些資源建立動作來指定資源的標籤。在這種情況下，如果在建立資源時無法套用標籤，則無法建立資源。該機制可確保您要在建立時標記的資源是以指定的標籤建立，不然就根本不會建立。如果您在建立時標記資源，則不需要在建立資源之後執行自訂標記指令碼。

下表描述了可加上標籤的 Amazon EMR on EKS 資源。

標籤限制

以下基本限制適用於標籤：

使用 AWS CLI 和 Amazon EMR on EKS API 來處理標籤

使用下列 AWS CLI 命令或 Amazon EMR on EKS API 操作來新增、更新、列出及刪除資源的標籤。

下列範例示範如何使用 AWS CLI 來標記或取消標記資源。

範例 1：為現有虛擬叢集加上標籤

以下命令會為現有叢集加上標籤。

aws emr-containers tag-resource --resource-arn resource_ARN --tags team=devs

範例 2：取消現有虛擬叢集的標籤

以下命令從現有虛擬叢集中刪除標籤。

aws emr-containers untag-resource --resource-arn resource_ARN --tag-keys tag_key

範例 3：列出資源的標籤

以下命令列出與現有資源相關聯的標籤。

aws emr-containers list-tags-for-resource --resource-arn resource_ARN