為您的 Amazon EMR on EKS 資源加上標籤 - Amazon EMR
標籤基本概念標記您的 資源標籤限制使用 AWS CLI 和 Amazon EMR on EKS API 來處理標籤

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

為您的 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 資源。

資源 支援標籤 支援標籤傳播 支援在建立時加上標簽 (Amazon EMR on EKS API、AWS CLI 和 AWS SDK) 用於建立的 API (可以在建立過程中新增標籤)
虛擬叢集 是 否。與虛擬叢集關聯的標籤不會傳播到提交至該虛擬叢集的作業執行。 是 CreateVirtualCluster
任務執行 是 否 是 StartJobRun

標籤限制

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

  • 每一資源最多標籤數 – 50

  • 對於每一個資源，每個標籤金鑰必須是唯一的，且每個標籤金鑰只能有一個值。

  • 索引鍵長度上限 - 128 個 UTF-8 Unicode 字元

  • 值的長度上限 - 256 個 UTF-8 Unicode 字元

  • 如果您的標記結構描述用於多個 AWS 服務和資源，請記得，其他服務可能限制允許的字元。通常允許的字元包括：可用 UTF-8 表示的英文字母、數字和空格，還有以下字元：+ - = . _ : / @。

  • 標籤鍵與值皆區分大小寫。

  • 標籤值可以為空白字串，但不得是 null。標籤金鑰不得為空白字串。

  • 請勿使用 aws:、AWS: 或任何大小寫組合作為索引鍵或值的字首。因為僅預留給 AWS 使用。

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

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

任務 AWS CLI API 動作
新增或覆寫一或多個標籤 tag-resource TagResource
列出資源的標籤 list-tags-for-resource ListTagsForResource
刪除一或多個標籤 untag-resource UntagResource

下列範例示範如何使用 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