tencent cloud

Tag

Product Introduction
Overview
Features
Scenarios
Use Limits
Resource Types Supporting Tag APIs
Purchase Guide
Getting Started
Creating Tags and Binding Resources
Querying Resources by Tag
Operation Guide
Creating Tags
Tagging Resources
Unbinding Tags
Unbinding or Modifying Tags in Batches
Deleting Tags
Viewing Tagged Resources
Querying and Editing Resource Tags
Setting Tag Quotas
Exporting Resource Tags
Query Tag Modification Record
CreatedBy
Tag Policy
Exporting a Tag List
API Documentation
History
Introduction
API Category
Making API Requests
Write APIs
Read APIs
Project APIs
Data Types
Error Codes
FAQs
Glossary
DocumentationTagProduct IntroductionUse Limits

Use Limits

PDF
Focus Mode
Font Size
Last updated: 2025-09-02 16:23:57

Quantity

A tag consists of 1 tag key and 1 tag value (tagKey:tagValue).
Each resource can have 50 tags at most.
For each resource, each tag key can have only 1 value. If you bind a new tag value to the same tag key of the same resource, the original tag value will be overwritten instead of retaining two tag values simultaneously.
Tag keys cannot be created separately, they must be created simultaneously with tag values (the one-time creation cap for relevant APIs is 10).
Under one primary account, the total number of tag key-value pairs is limited to 1 million.

Naming

Limit
Tag Key
Tag Value
System-reserved Key
Tag keys starting with qcs: , project ,项目are reserved for Tencent Cloud use. Do not use the prefixes when you create a tag key.
-
Length
In UTF-8, a tag key must be 1 to 127 Unicode characters.
In UTF-8, a tag value must be 1 to 255 Unicode characters.
Character
In UTF-8, the limits are as follows:
Supports Chinese and English characters. If it is an English character, it is case-sensitive.
Supports multiple characters with spaces in the middle, but does not support spaces at the beginning or end.
Supports digits 0–9.
Supports specific special characters:
In English: + - = . _ : / @ ( ) [ ] , ; > <.
In Chinese: + - = / @ （ ） 【 】 ：.
Previous Topic: ScenariosNext Topic: Resource Types Supporting Tag APIs

Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback