Tags are used to label clusters. You can use tags to identify and manage your cluster resources. You can bind tags during the creation of a cluster or on the Cluster Overview page of a created cluster. You can bind a maximum of 20 tags to a cluster.

Background information

Notes:
  • Tags of ECS instances are also updated when you update E-MapReduce (EMR) cluster tags.
  • However, EMR cluster tags are not updated when you update tags of ECS instances. To ensure the consistency between the tags for ECS instances and EMR clusters, we recommend that you do not modify the tags of ECS instances in the ECS console. If the number of tags of an ECS instance in a cluster reaches the upper limit, you can no longer create tags for the cluster.
  • Tag information is not shared across regions.

    For example, tags created in the China (Hangzhou) region are not visible to the China (Shanghai) region.

Create or bind a tag

  1. Log on to the EMR console.
  2. In the top navigation bar, select the region where your cluster resides and select a resource group based on your business requirements.
  3. Click Cluster Wizard in the Clusters section. In the Advanced Settings section of the Basic Settings step, click + Add on the right side of Tag.
    For more information about how to create a cluster, see Create a cluster.
  4. In the Create/Bind Tag dialog box, select an existing tag key or enter a new one to set Tag Key. Tag Value is optional. You can select an existing tag value or enter a new value.
    Create/Bind Tag dialog box
    Note If you select an existing tag key and tag value, it indicates that you want to bind an existing tag. If you enter a new tag key, it indicates that you want to create a tag.
    Limits on tag keys and tag values:
    • Each tag consists of a key-value pair.
    • A tag key cannot be empty and can have a maximum of 64 characters. A tag value can be empty and can have a maximum of 128 characters.
    • Tag keys and tag values cannot start with aliyun or acs: and cannot contain http:// or https://.
    • A tag key must be unique. For example, city:shanghai is bound to a cluster. If city:newyork is then bound to the cluster, city:shanghai is automatically unbound.
  5. Click Confirm.
    Confirm the tag to be bound.
  6. Click Confirm.
    The tag is bound.

Use tags to search for clusters

On the Cluster Management tab, search for a destination cluster by using a tag key or tag value.

  1. Log on to the EMR console.
  2. In the top navigation bar, select the region where your cluster resides and select a resource group based on your business requirements.
  3. Click the Cluster Management tab.
  4. On the Cluster Management page, click Tag and select a tag key.
    If you do not select a tag value, all clusters bound to the tag key are displayed.
  5. Click Search next to Tag.
    Clusters that meet the search criterion are displayed in a list.

Manage cluster tags

You can bind, unbind, or view tags of existing clusters.

  1. Log on to the EMR console.
  2. In the top navigation bar, select the region where your cluster resides and select a resource group based on your business requirements.
  3. Click the Cluster Management tab.
  4. Click Details in the Actions column that corresponds to a cluster in the list.
  5. On the Cluster Overview page, click Edit Tag in the Cluster Info section.
  6. In the Edit Tag dialog box, configure the following information:
    • Create a tag.
      1. Click Add Tag in the lower-left corner.
      2. Specify Tag Key and Tag Value.
      3. Click Confirm.
      4. Click Confirm.
    • Bind an existing tag.
      1. Click Existing Tags in the lower-left corner.
      2. Select an existing tag key and the tag value that matches.
      3. Click Confirm.
    • Unbind a tag.
      Click the Unbind icon next to a tag to unbind this tag.
      Note After you unbind a tag from a cluster, the system automatically deletes the tag if the tag is not bound to any other clusters.

System tags

When you create an EMR cluster, two system tags are automatically bound to each ECS instance. You can perform the following operations to identify the cluster to which an ECS instance belongs and the role of the ECS instance in the cluster: Log on to the Alibaba Cloud ECS console. Click Tags in the left-side navigation pane. On the Tags page, click System Tags in the left-side navigation tree on the Tags tab.

For example, the following information shows the system tags for an ECS instance, which indicates that the ECS instance serves as a core node in the EMR cluster with the ID of C-A510C93EA117XXXX.
  • acs:emr:clusterId=C-A510C93EA117XXXX
  • acs:emr:hostGroupType=CORE