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

# 為您的 Amazon EMR on EKS 資源加上標籤
<a name="tag-resources"></a>

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

**Topics**
+ [標籤基本概念](#tag-resources-tag-basics)
+ [標記您的 資源](#tag-resources-add-tags)
+ [標籤限制](#tag-resources-restrictions)
+ [使用 AWS CLI 和 Amazon EMR on EKS API 處理標籤](#tag-resources-work-with-tags)

## 標籤基本概念
<a name="tag-resources-tag-basics"></a>

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

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

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

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

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

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

如需標籤型存取控制政策範例，請參閱 [標籤型存取控制政策](security_iam_TBAC.md)。

## 標記您的 資源
<a name="tag-resources-add-tags"></a>

可以為新的或現有的虛擬叢集以及處於使用中狀態的作業執行加上標籤。作業執行的作用中狀態包括：`PENDING`、`SUBMITTED`、`RUNNING` 和 `CANCEL_PENDING`。虛擬叢集的作用中狀態包括：`RUNNING`、`TERMINATING` 和 `ARRESTED`。如需詳細資訊，請參閱[作業執行狀態](emr-eks-jobs-states.md)及[虛擬叢集狀態](virtual-cluster.md#virtual-cluster-states)。

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

如果您使用的是 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 | 

## 標籤限制
<a name="tag-resources-restrictions"></a>

以下基本限制適用於標籤：
+ 每一資源最多標籤數 – 50
+ 對於每一個資源，每個標籤金鑰必須是唯一的，且每個標籤金鑰只能有一個值。
+ 索引鍵長度上限 - 128 個 UTF-8 Unicode 字元
+ 值的長度上限 - 256 個 UTF-8 Unicode 字元
+ 如果您的標記結構描述用於多個 AWS 服務和資源，請記住，其他服務可能有允許的字元限制。通常允許的字元包括：可用 UTF-8 表示的英文字母、數字和空格，還有以下字元：\$1 - = . \$1 : / @。
+ 標籤鍵與值皆區分大小寫。
+ 標籤值可以為空白字串，但不得是 null。標籤金鑰不得為空白字串。
+ 請勿使用 `aws:`、`AWS:` 或任何大小寫組合作為索引鍵或值的字首。這些僅供保留 AWS 使用。

## 使用 AWS CLI 和 Amazon EMR on EKS API 處理標籤
<a name="tag-resources-work-with-tags"></a>

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


****  

| 任務 | AWS CLI | API 動作 | 
| --- | --- | --- | 
| 新增或覆寫一或多個標籤 | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/emr-containers/tag-resource.html) | [TagResource](https://docs.aws.amazon.com/emr-on-eks/latest/APIReference/API_TagResource.html) | 
| 列出資源的標籤 | [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/emr-containers/list-tags-for-resource.html) | [ListTagsForResource](https://docs.aws.amazon.com/emr-on-eks/latest/APIReference/API_ListTagsForResource.html) | 
| 刪除一或多個標籤 | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/emr-containers/untag-resource.html) | [UntagResource](https://docs.aws.amazon.com/emr-on-eks/latest/APIReference/API_UntagResource.html) | 

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