Express Connect circuits and shared ports support tags. You can use tags to label and classify Express Connect circuits and shared ports, which facilitates resource search and aggregation. This topic describes how to manage and use tags of Express Connect circuits and shared ports.

Tag overview

Tags are used to classify instances. Each tag consists of a key-value pair. Take note of the following limits when you use tags:
  • The keys of tags that are added to the same instance must be unique.
  • When you add a tag, you must specify the tag key, but you can leave the tag value empty.
  • You cannot create tags without adding them to instances. All tags must be added to instances.
  • Tag information is not shared across regions.

    For example, if you are in the China (Shanghai) region, you cannot view tags created in the China (Hangzhou) region.

  • You can modify the key and the value of a tag or remove a tag from an instance.
  • If you delete an instance, all tags added to the instance are deleted. This operation does not affect the tags added to other instances.
  • When you add tags to an instance or modify the tags of an instance, you can add up to 20 tags to each instance.
  • Only the payer of a dedicated Express Connect circuit or a shared Express Connect circuit can edit resource tags.

Prerequisites

At least one dedicated Express Connect circuit and one shared port are created in the specified region. For more information, see Create and manage a dedicated connection over an Express Connect circuit and Create a shared port for a new hosted connection.

Add tags

Add tags to Express Connect circuits

  1. Log on to the Express Connect console.
  2. In the top navigation bar, select a region based on your business requirements.
  3. On the Physical Connection page, perform the following operations to add tags to Express Connect circuits:
    • Add tags to an instance
      1. You can add tags to an instance by using one of the following methods.
        Case Method 1 Method 2
        No tags are added to the instance that you want to manage.
        1. Find the Express Connect circuit that you want to manage and move the pointer over the Tag icon icon in the Label column.
        2. Click Add in the pop-up box.
        1. Find the Express Connect circuit that you want to manage and click the ID of the circuit.
        2. In the Basic Information section of the instance details page, move the pointer over the Tag icon icon on the right side of Label.
        3. Click Add in the pop-up box.
        Tags are added to the instance that you want to manage.
        1. Find the Express Connect circuit that you want to manage and move the pointer over the Tag icon icon in the Label column.
        2. Click Edit in the pop-up box.
        1. Find the Express Connect circuit that you want to manage and click the ID of the circuit.
        2. In the Basic Information section of the instance details page, move the pointer over the Tag icon icon on the right side of Label.
        3. Click Edit in the pop-up box.
      2. In the Configure Tags dialog box, specify the key and the value, and click OK.
        Parameter Description
        Tag Key You can select or enter a tag key.

        The tag key must be 1 to 64 characters in length, and cannot start with aliyun or acs:. It cannot contain http:// or https://.

        Tag Value You can select or enter a tag value.

        The tag value can be 1 to 128 characters in length, but cannot start with aliyun or acs:. It cannot contain http:// or https://.

    • Add tags to multiple instances
      1. Select the instances to which you want to add tags and choose Set label > Batch add labels in the lower-left corner.
      2. In the Configure Tags for Multiple Resources dialog box, specify Tag Key and Tag Value, and click OK.

Add tags to shared ports

  1. Log on to the Express Connect console.
  2. In the top navigation bar, select a region based on your business requirements.
  3. On the Physical Connection page, find the dedicated Express Connect circuit that you want to manage and click the ID of the circuit.
  4. On the instance details page, click the Shared Physical Connection tab and perform the following operations to add tags to shared ports:
    • Add tags to an instance
      1. You can add tags to an instance by using one of the following methods.
        Case Procedure
        No tags are added to the instance that you want to manage.
        1. Find the shared port that you want to manage and move the pointer over the Tag icon icon in the Label column.
        2. Click Add in the pop-up box.
        Tags are added to the instance that you want to manage.
        1. Find the shared port that you want to manage and move the pointer over the Tag icon icon in the Label column.
        2. Click Edit in the pop-up box.
      2. In the Configure Tags dialog box, specify the key and the value, and click OK.
        Parameter Description
        Tag Key You can select or enter a tag key.

        The tag key must be 1 to 64 characters in length, and cannot start with aliyun or acs:. It cannot contain http:// or https://.

        Tag Value You can select or enter a tag value.

        The tag value can be 1 to 128 characters in length, but cannot start with aliyun or acs:. It cannot contain http:// or https://.

    • Add tags to multiple instances
      1. Select the instances to which you want to add tags and choose Set label > Batch add labels in the lower-left corner.
      2. In the Configure Tags for Multiple Resources dialog box, specify Tag Key and Tag Value, and click OK.

Filter instances by tag

After you add tags to instances, you can filter instances by tag.

Filter Express Connect circuits by tag

  1. Log on to the Express Connect console.
  2. In the top navigation bar, select a region based on your business requirements.
  3. On the Physical Connection page, click Label filtering.
  4. In the Filter by Tag dialog box, select or enter a tag key and a tag value.
    You can select or enter a key-value pair, or select or enter only a tag key.
  5. Click Search to query the filtered Express Connect circuits.
    In the section below Create Physical Connection, you can view the valid filter conditions. You can also click Clear search criteria to clear the current filter conditions.

Filter shared ports by tag

  1. Log on to the Express Connect console.
  2. In the top navigation bar, select a region based on your business requirements.
  3. On the Physical Connection page, find the dedicated Express Connect circuit that you want to manage and click the ID of the circuit.
  4. On the instance details page, click the Shared Physical Connection tab, and then click Label filtering.
  5. In the Filter by Tag dialog box, select or enter a tag key and a tag value.
    You can select or enter a key-value pair, or select or enter only a tag key.
  6. Click Search to query the filtered shared ports.
    In the section below Create Shared Port, you can view the valid filter conditions. You can also click Clear search criteria to clear the current filter conditions.

Remove tags from instances

Remove tags from Express Connect circuits

If a tag is added to multiple instances and you remove the tag from an instance, the tag is not removed from other instances.

  1. Log on to the Express Connect console.
  2. In the top navigation bar, select a region based on your business requirements.
  3. On the Physical Connection page, perform the following operations to remove tags from Express Connect circuits:
    • Remove tags from an instance
      1. You can find the tags that you want to remove by using one of the following methods.
        Method Procedure
        Method 1
        1. Find the Express Connect circuit that you want to manage and move the pointer over the Tag icon icon in the Label column.
        2. Click Edit in the pop-up box.
        Method 2
        1. Find the Express Connect circuit that you want to manage and click the ID of the circuit.
        2. In the Basic Information section of the instance details page, move the pointer over the Tag icon icon on the right side of Label.
        3. Click Edit in the pop-up box.
      2. In the Configure Tags dialog box, find the key-value pair that you want to remove, click the Delete icon icon on the right side of the key-value pair, and then click OK.
    • Remove tags from multiple instances
      1. Select the Express Connect circuits from which you want to remove tags and choose Set label > Batch delete labels in the lower-left corner.
      2. In the Delete Tags for Multiple Resources dialog box, find the key-value pairs that you want to remove, click the Delete icon icon on the right side of the key-value pairs, and then click OK.

Remove tags from shared ports

  1. Log on to the Express Connect console.
  2. In the top navigation bar, select a region based on your business requirements.
  3. On the Physical Connection page, find the dedicated Express Connect circuit that you want to manage and click the ID of the circuit.
  4. On the instance details page, click the Shared Physical Connection tab and perform the following operations to remove tags from shared ports:
    • Remove tags from an instance
      1. You can find the tags that you want to remove by using the following method:
        1. Find the shared port that you want to manage and move the pointer over the Tag icon icon in the Label column.
        2. Click Edit in the pop-up box.
      2. In the Configure Tags dialog box, find the key-value pair that you want to remove, click the Delete icon icon on the right side of the key-value pair, and then click OK.
    • Remove tags from multiple instances
      1. Select the Express Connect circuits from which you want to remove tags and choose Set label > Batch delete labels in the lower-left corner.
      2. In the Delete Tags for Multiple Resources dialog box, find the key-value pairs that you want to remove, click the Delete icon icon on the right side of the key-value pairs, and then click OK.

References