Updated on 2024-06-11 GMT+08:00

Tag Management

This section describes how to search for clusters based on tags and how to add, modify, and delete tags.

Adding a Tag to a Cluster

  1. On the Clusters > Dedicated Clusters page, click the name of the cluster to which a tag is to be added, and choose Tag.

  2. Click Add Tag.
  3. Configure tag information in the Add Tag dialog box. The value of a key cannot be left blank.

    Table 1 Tag parameters

    Parameter

    Description

    Example Value

    Tag key

    You can:

    • Select a predefined tag key or an existing resource tag key from the drop-down list of the text box.
      NOTE:

      To add a predefined tag, you need to create one on TMS and select it from the drop-down list of Tag key. You can click View predefined tags to enter the Predefined Tags page of TMS. Then, click Create Tag to create a predefined tag.

    • Enter a tag key in the text box. The tag key can contain a maximum of 128 characters and cannot be an empty string. It cannot start with _sys_.
      Only letters, digits, spaces, and the following characters are allowed: _ . : = + - @
      NOTE:

      A key must be unique in a given cluster.

    key01

    Tag value

    You can:

    • Select a predefined tag value or resource tag value from the drop-down list of the text box.
    • Enter a tag value in the text box. The tag key can contain a maximum of 255 characters and cannot be an empty string.

      Only letters, digits, spaces, and the following characters are allowed: : = + - @.

    value01

  4. Click OK.

Searching for Clusters Based on Tags

You can quickly locate a tagged cluster using tags.

  1. Log in to the GaussDB(DWS) management console.
  2. Choose Clusters > Dedicated Cluster.
  3. Click Search by Tag on the upper right of the cluster list to expand the tab page.
  4. In the Search by Tag area, click the Tag Key text box to select a tag key from the drop-down list and then click the Tag Value text box to select the corresponding tag value.

    You can only enter a tag key or value that exists in the drop-down list. If no tag key or value is available, create a tag for the cluster. For details, see Adding a Tag to a Cluster.

  5. Click to add the selected tag to the area under the text boxes.

    • Select another tag in the text boxes and click to generate a tag combination for cluster search. You can add a maximum of 10 tags to search for data warehouse clusters. If you specify more than one tag, clusters containing all the specified tags will be displayed.
    • To delete an existing tag, click next to the tag.
    • You can click Reset to clear all added tags.

  6. Click Search. The target cluster will be displayed in the cluster list.

Modifying a Tag

  1. On the Clusters > Dedicated Clusters page, click the name of the cluster to which a tag is to be added, and choose Tag.
  2. Locate the row that contains the tag to be modified, and click Edit in the Operation column. The Edit Tag dialog box is displayed.
  3. Enter the new key value in the Value text box.
  4. Click OK.

Deleting a Tag

  1. On the Clusters > Dedicated Clusters page, click the name of the cluster from which a tag is to be deleted, and click the Tags tab.
  2. Locate the row that contains the tag to be deleted, click Delete in the Operation column. The Delete Tag dialog box is displayed.
  3. Click Yes to delete the tag.