本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 標記和分類 Amazon EMR 叢集資源
您可以方便地以不同的方式分類您的 AWS 資源，例如，依用途、擁有者或環境。您可以透過使用標籤來將自訂中繼資料指派到 Amazon EMR 叢集以在 Amazon EMR 中達成此目的。每個標記皆包含由您定義的金鑰和值。對於 Amazon EMR，叢集是您可以新增標籤的資源層級。例如，您可以為帳戶叢集定義一組標籤，可協助您追蹤每個叢集的擁有者或識別生產叢集和測試叢集。我們建議您建立一組一致的標籤，以滿足您組織的需求。
當您將標籤新增到 Amazon EMR 叢集時，該標籤也會傳播到與該叢集相關聯的每個作用中的 Amazon EC2 執行個體。同樣地，當您從 Amazon EMR 叢集移除某個標籤，會將該標籤從每個相關作用中的 Amazon EC2 執行個體中移除。
**重要**
使用 Amazon EMR 主控台或 CLI 來管理屬於某叢集 (而不是 Amazon EC2 主控台或 CLI) 之 Amazon EC2 執行個體上的標籤，因為您在 Amazon EC2 中所做的變更未與 Amazon EMR 標記系統同步。
您可以透過尋找下列系統標籤來識別屬於 Amazon EMR 叢集的 Amazon EC2 執行個體。在這個範例中，*CORE* 是執行個體群組角色的值，而 *j-12345678* 是範例任務流程 (叢集) 的識別符值：
+ aws:elasticmapreduce:instance-group-role=*CORE*
+ aws:elasticmapreduce:job-flow-id=*j-12345678*
**注意**
Amazon EMR 和 Amazon EC2 將您的標籤解釋為字元字串，而不含任何語意。
您可以使用 AWS 管理主控台、 CLI 和 API 來使用標籤。
您可以在建立新 Amazon EMR 叢集時新增標籤，您可以從執行中 Amazon EMR 叢集中新增、編輯或移除標籤。編輯標籤這個概念適用於 Amazon EMR 主控台，但若使用 CLI 和 API 來編輯標籤，會移除舊標籤並新增標籤。您可以編輯標籤金鑰和數值，並且可以在叢集執行時將標籤從資源中移除。不過，您無法從先前與仍作用中的叢集相關聯之終止叢集或終止執行個體中新增、編輯或移除標籤。此外，您可以將標籤的值設為空白字串，但您無法將標籤的值設為 null。
如果您使用 AWS Identity and Access Management (IAM) 搭配 Amazon EC2 執行個體，依標籤取得以資源為基礎的許可，您的 IAM 政策會套用至 Amazon EMR 傳播到叢集 Amazon EC2 執行個體的標籤。對於傳播到 Amazon EC2 執行個體的 Amazon EMR 標籤，Amazon EC2 的 IAM 政策需要允許許可，才能呼叫 Amazon EC2 CreateTags 和 DeleteTags API。此外，傳播標籤會影響 Amazon EC2 的資源型許可。可將傳播到 Amazon EC2 的標籤讀取做為 IAM 政策中的條件，就像其他 Amazon EC2 標籤。在將標籤新增到 Amazon EMR 叢集時，需謹記 IAM 政策，以避免使用者擁有不正確的叢集許可。為了避免問題，確保 IAM 政策不包含您計劃對 Amazon EMR 叢集使用的標籤條件。(如需詳細資訊，請參閱[控制 Amazon EC2 資源的存取](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UsingIAM.html))。
# 適用於在 Amazon EMR 中標記資源的限制
以下基本限制適用於 標籤：
+ 適用於 Amazon EC2 資源的限制也適用於 Amazon EMR。如需詳細資訊，請參閱[https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-restrictions](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-restrictions)。
+ 請勿在標籤名稱和值中使用 `aws:`字首，因為它保留供 AWS 使用。此外，您不可編輯或刪除具此字首的標籤名稱或值。
+ 您無法變更或編輯已終止叢集上的標籤。
+ 標籤值可以為空白字串，但不得是 null。此外，標籤金鑰不得為空白字串。
+ 金鑰和值可包含任何語言的字母字元、數字字元、空格、隱藏分隔符號和下列符號：\$1 . : / = \$1 - @
如需使用 標記的詳細資訊 AWS 管理主控台，請參閱《*Amazon EC2 使用者指南*》[中的在主控台中使用標籤](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#Using_Tags_Console)。如需使用 Amazon EC2API 或命令列標記的詳細資訊，請參閱《*Amazon EC2 使用者指南*》中的 [API 和 CLI 概觀](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#Using_Tags_CLI)。
# 標記 Amazon EMR 資源以進行計費
您可以使用標籤來整理 AWS 帳單，以反映您自己的成本結構。若要這樣做，請註冊以取得包含標籤索引鍵值 AWS 的帳戶帳單。您可以依標籤金鑰值來組織帳單資訊，藉此查看您的組合資源成本。雖然 Amazon EMR 和 Amazon EC2 有不同的帳單，每個叢集上的標籤也會放置在每個關聯執行個體，因此您可以使用標籤來連結相關 Amazon EMR 和 Amazon EC2 成本。
例如，您可以使用特定應用程式名稱來標記數個資源，然後整理帳單資訊以查看該應用程式跨數項服務的總成本。如需詳細資訊，請參閱《AWS Billing 使用者指南》**中的[成本配置和標記](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation.html)。
# 將標籤新增至 Amazon EMR 叢集
您可以在建立叢集時向其新增標籤。
------
#### [ Console ]
**在使用新主控台建立叢集時新增標籤**
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/emr](https://console.aws.amazon.com/emr) 開啟 Amazon EMR 主控台。
1. 在左側導覽窗格中的 **EC2 上的 EMR** 下，選擇**叢集**，然後選擇**建立叢集**。
1. 在**標籤**下，選擇**新增標籤**。在**金鑰**欄位中指定標籤。(選用) 在**值**欄位中指定標籤。
1. 選擇適用於您的叢集的任何其他選項。
1. 若要啟動您的叢集，請選擇**建立叢集**。
------
#### [ AWS CLI ]
**當您使用 建立叢集時新增標籤 AWS CLI**
以下範例示範如何使用 AWS CLI將標籤新增到叢集。若要在建立叢集時新增標籤，請鍵入含 `create-cluster` 參數的 `--tags` 子命令。
+ 若要在建立叢集時使用鍵值 *marketing* 來新增名為 *costCenter* 的標籤，請輸入以下命令，並使用 EC2 金鑰對來取代 *myKey*。
```
aws emr create-cluster --name "Test cluster" --release-label emr-4.0.0 --applications Name=Hadoop Name=Hive Name=Pig --tags "costCenter=marketing" --use-default-roles --ec2-attributes KeyName=myKey --instance-type m5.xlarge --instance-count 3
```
若您未使用 `--instance-groups` 參數指定執行個體計數，即會啟動單一主節點，且剩餘執行個體會以核心節點的形式啟動。所有節點都將使用命令中指定的執行個體類型。
**注意**
如果您先前尚未建立預設 EMR 服務角色和 EC2 執行個體描述檔，請先輸入 aws `emr create-default-roles` 來建立這些設定檔，接著再輸入 `create-cluster` 子命令。
如需在 中使用 Amazon EMR 命令的詳細資訊 AWS CLI，請參閱 [https://docs.aws.amazon.com/cli/latest/reference/emr](https://docs.aws.amazon.com/cli/latest/reference/emr)。
------
您也可以將標籤新增到現有的叢集。
------
#### [ Console ]
**使用新主控台將標籤新增至現有叢集**
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/emr](https://console.aws.amazon.com/emr) 開啟 Amazon EMR 主控台。
1. 在左側導覽窗格中的 **EC2 上的 EMR** 下，選擇**叢集**，然後選取您要更新的叢集。
1. 在叢集詳細資訊頁面的**標籤**標籤上，選取**管理標籤**。在**金鑰**欄位中指定標籤。(選用) 在**值**欄位中指定標籤。
1. 選取**儲存變更**。**標籤**索引標籤會更新您叢集上的新標籤數量。例如，如果您現在具有兩個標籤，則索引標籤的標籤是**標籤 (2)**。
------
#### [ AWS CLI ]
**使用 將標籤新增至執行中的叢集 AWS CLI**
+ 輸入含 `--tag` 參數的 `add-tags` 子命令以將標籤指派至叢集 ID。您可以使用主控台或 `list-clusters` 命令來尋找叢集 ID。`add-tags` 子指令目前僅接受一個資源 ID。
例如，若要將兩個標籤新增至執行中的叢集 (一個內含值為 *marketing*、名為 *costCenter* 的金鑰，另一個內含值為 *accounting*、名為 *other* 的金鑰)，請輸入下列命令並使用 *j-KT4XXXXXXXX1NM* 取代為您的叢集 ID。
```
aws emr add-tags --resource-id j-KT4XXXXXXXX1NM --tag "costCenter=marketing" --tag "other=accounting"
```
請注意，使用 AWS CLI 新增標籤時，命令中沒有輸出。如需在 中使用 Amazon EMR 命令的詳細資訊 AWS CLI，請參閱 [https://docs.aws.amazon.com/cli/latest/reference/emr](https://docs.aws.amazon.com/cli/latest/reference/emr)。
------
# 檢視 Amazon EMR 叢集上的標籤
如果想要查看所有與叢集關聯的標籤，您可以使用主控台或 AWS CLI進行查看。
------
#### [ Console ]
**使用新主控台檢視叢集上的標籤**
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/emr](https://console.aws.amazon.com/emr) 開啟 Amazon EMR 主控台。
1. 在左側導覽窗格中的 **EC2 上的 EMR** 下，選擇**叢集**，然後選取您要更新的叢集。
1. 若要檢視所有標籤，請選取叢集詳細資訊頁面上的**標籤**索引標籤。
------
#### [ AWS CLI ]
**使用 檢視叢集上的標籤 AWS CLI**
若要使用 檢視叢集上的標籤 AWS CLI，請使用 `--query` 參數輸入 `describe-cluster` 子命令。
+ 要查看叢集的標籤，輸入下列命令，並使用叢集 ID 取代 *j-KT4XXXXXXXX1NM*。
```
1. aws emr describe-cluster --cluster-id j-KT4XXXXXX1NM --query Cluster.Tags
```
此輸出會顯示與以下類似之叢集的所有標籤資訊：
```
Value: accounting Value: marketing
Key: other Key: costCenter
```
如需在 中使用 Amazon EMR 命令的詳細資訊 AWS CLI，請參閱 [https://docs.aws.amazon.com/cli/latest/reference/emr](https://docs.aws.amazon.com/cli/latest/reference/emr)。
------
# 從 Amazon EMR 叢集移除標籤
如果您不再需要標籤，您可以將其從叢集中移除。
------
#### [ Console ]
**使用新主控台移除叢集上的標籤**
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/emr](https://console.aws.amazon.com/emr) 開啟 Amazon EMR 主控台。
1. 在左側導覽窗格中的 **EC2 上的 EMR** 下，選擇**叢集**，然後選取您要更新的叢集。
1. 在叢集詳細資訊頁面的**標籤**標籤上，選取**管理標籤**。
1. 針對您要移除的每個金鑰值對選擇**移除**。
1. 選擇**儲存變更**。
------
#### [ AWS CLI ]
**使用 移除叢集上的標籤 AWS CLI**
鍵入含 `--tag-keys` 參數的 `remove-tags` 子命令。移除標籤時，只需要金鑰名稱即可。
+ 要將標籤從叢集中移除，輸入下列命令，並使用叢集 ID 取代 *j-KT4XXXXXXXX1NM*。
```
aws emr remove-tags --resource-id j-KT4XXXXXX1NM --tag-keys "costCenter"
```
**注意**
您目前無法使用單一命令來移除多個標籤。
如需在 中使用 Amazon EMR 命令的詳細資訊 AWS CLI，請參閱 [https://docs.aws.amazon.com/cli/latest/reference/emr](https://docs.aws.amazon.com/cli/latest/reference/emr)。
------