在 EKS 資源上標記您的 Amazon EMR - Amazon EMR

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

在 EKS 資源上標記您的 Amazon EMR

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

標籤基本概念

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

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

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

標籤對 EKS 上的 Amazon EMR 來説不具有任何語意意義,並會嚴格解譯為字元字串。

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

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

有關標籤型存取控制政策示例,請參閲標籤型存取控制的政策

標記您的 資源

您可以標記新的或現有的虛擬叢集,以及處於活動狀態的任務執行標記。作業運行的活動狀態包括:PENDINGSUBMITTEDRUNNING,以及CANCEL_PENDING。虛擬羣集的活動狀態包括:RUNNINGTERMINATINGARRESTED。如需更多詳細資訊,請參閱 Job 執行狀態虛擬羣集狀態

當虛擬羣集終止時,標籤將被清理並且不再可訪問。

如果您在 EKS 上使用 Amazon EMR API,則AWS CLI,或AWS開發套件,您可以在相關 API 動作上使用 tags 參數,將標籤套用到新資源。您也可以使用 TagResource API 動作將標籤套用到現有資源。

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

下表描述了可標記的 EKS 資源。

資源 支援標籤 支援標籤傳播 支援在建立時標記 (EKS API 上的 Amazon EMRAWS CLI,以及AWS開發套件) 用於創建的 API(標籤可以在創建過程中添加)
虛擬叢集 否. 與虛擬羣集關聯的標記不會傳播到提交給該虛擬羣集的作業運行。 創建虛擬羣集
Job 執行 StartJobRun

標籤限制

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

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

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

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

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

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

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

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

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

透過AWS CLI以及 EKS 上的 Amazon EMR

使用以下內容AWS CLI命令或 Amazon EMR 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