Updated on 2025-08-27 GMT+08:00

Record Set Tags

Scenarios

A tag is the identifier of a record set. Adding tags to record sets helps you identify and manage your record sets. You can add tags when adding a record set or add tags to an existing record set. Up to 20 tags can be added to a record set.

If your organization has configured tag policies for the DNS service, you need to add tags to your record sets based on the tag policies. If you add a tag that does not comply with the tag policies, record sets may fail to be created. Contact the administrator to learn more about tag policies.

A tag consists of a key and value pair. Table 1 lists the tag key and value requirements.

Table 1 Tag key and value requirements

Parameter

Requirements

Example

Key

  • Cannot be left blank.
  • Must be unique for each resource.
  • Can contain a maximum of 128 characters.
  • Cannot start or end with a space, or cannot start with _sys_. Only letters, digits, spaces, and the following special characters are allowed: _.:=+-@

example_key1

Value

  • Can be left blank.
  • Can contain a maximum of 255 characters.
  • Can contain letters, digits, spaces, and the following special characters: _.:/=+-@

example_value1

Searching for Record Sets by Tag

In the record set list, search for record sets by tag key or value.

  1. Go to the DNS console.
  2. On the Overview page, click Record Sets.
  3. Select the Public Zone Record Sets or Private Zone Record Sets tab.

    Alternatively, on the Public Zones or Private Zones page, click the domain name to go to the Record Sets tab.

    To search for record sets of private zones, click in the upper left corner of the management console and select a region and project.

  4. In the search box above the list, select a tag as instructed.

    You can search zones by tag key or by key-value pair.

    You can add one or more tags. If keys are different, the AND operator is used to filter search results.

    If keys are the same but values are different, the AND operator is used to filter search results.

    • Search by a single tag.
      1. Select a tag key in the search box above the record set list.
      2. Select a tag value for the tag key and start the search.
    • Search by multiple tags.

      Repeat 4.a to 4.b, select multiple tag key-value pairs, and search for the zones.

Managing Record Set Tags

You can add, delete, modify, and query tags on the Tags tab on the record set details page.
  1. Go to the DNS console.
  2. On the Overview page, click Record Sets.
  3. Select the Public Zone Record Sets or Private Zone Record Sets tab.

    Alternatively, on the Public Zones or Private Zones page, click the domain name to go to the Record Sets tab.

    To search for record sets of private zones, click in the upper left corner of the management console and select a region and project.

  1. In the upper right corner of the record set list, click and select Tag.

  2. In the Tag column of the target record set, add, delete, modify, and view tags.
    • Viewing tags

      In the Tag column of the target record set, view details about tags such as the number of tags and the key and value of each tag.

    • Adding, editing, and deleting tags
      1. Click next to the tag of the target record set.

      2. Add, edit, and delete tags as instructed.