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

Private Zone Tags

Scenarios

A tag is the identifier of a private zone. Adding tags to private zones helps you identify and manage your private zones. You can add tags when creating a private zone or add tags to existing private zones. Up to 20 tags can be added to a private zone.

If your organization has configured tag policies for the DNS service, you need to add tags to your private zones based on the tag policies. If you add a tag that does not comply with the tag policies, private zones 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 Private Zones by Tag

In the private zone list, search for private zones by tag.

  1. Go to the Private Zones page.
  2. In the search box above the private zone list, select a tag as instructed.

    You can search private 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. On the Private Zones page, select a tag key from the search box.
      2. Select a tag value for the tag key and start the search.
    • Search by multiple tags.

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

Managing Private Zone Tags

You can add, delete, modify, and query tags on the Tags tab on the private zone details page.
  1. Go to the Private Zones page.
  2. Click in the upper left corner and select the desired region and project.
  1. On the Private Zones page, click to view details about the private zone.

    The details of the private zone are displayed.

  2. Add, delete, modify, and query tags on the Tags tab.
    • Viewing tags

      On the Tags tab, view details about tags such as the number of tags and the key and value of each tag.

    • Adding a tag
      1. Click Add Tag above the tag list.
      2. Enter the key and value of the new tag as instructed and click OK.
    • Modifying a tag
      1. Locate the row that contains the tag and click Edit in the Operation column.
      2. Reset the tag key value as instructed and click OK.
    • Deleting a tag
      1. Locate the row that contains the tag and click Delete in the Operation column.
      2. Confirm the information about the tag to be deleted and click OK.