Docs

Torch Object Storage

Basic configurations

Tagging buckets

TOS supports tag-based resource management. Tags help you categorize buckets by purpose, type, owner, environment or other criteria, making managing cloud resources easier.

Introduction

As cloud resources grow, management complexity increases. Volcano Engine offers tag-based resource management, enabling customizable identification and classification of cloud service resources across various dimensions. You can use tags to organize cloud resources by business category, purpose, user, or other criteria.

With tags, you can manage TOS resources at the bucket level. A tag consists of a key-value pair, where a tag key is associated with exactly one tag value.

You can add multiple tags of different categories to each bucket, such as region:beijing or storageclass:standard. Each tag can be applied to multiple buckets. For example, you can assign the same tag owner:Alice to all buckets.

Use cases

Billing and cost allocation: If your business scenario requires cost allocation by different organizations or departments, you can use tags to classify cloud resources. Assign identical tags to cloud resources within the same organization or department to allocate costs during periodic billing.

warning

Exercise caution when deleting buckets or unbinding tags from them. Doing so can cause the tags to become empty in split bills. For more information, see Split bills.

Tagging rules

The rules for TOS tags are explained below.

Category	Description
Tag key	Supported characters: UTF-8 encoded characters, spaces, numbers, and special characters such as _.:/=+-@. Length: 1–128 characters. Case sensitivity: Type and type are considered two different tag keys.
Tag value	Supported characters: UTF-8 encoded characters, spaces, numbers, and special characters such as _.:/=+-@. Case sensitivity: Standard and standard are considered two different tag values. Length: 0–256 characters. The tag value can be empty.
Others	Each bucket can have up to 50 tags, but there is no global limit on total tags. You can add multiple tags to each bucket. However, tag keys under the same bucket cannot repeat. Each key can only have one value. Tag information is not shared across regions. For example, tags created in the China (Beijing) region are not visible in the China (Shanghai) region.

Adding a tag

In the left navigation pane, click Buckets. Then, navigate to the Bucket tagging page by doing the following:

On the Buckets page, hover over the tag icon in the Tag column of the bucket you want to configure. Then, click the edit icon that appears.

On the Buckets page, click the name of the bucket. In the left navigation pane, select Basic configurations > Bucket tagging.

Click Edit and Add tag to set the tag key and tag value.

tip

The tag key and value must follow certain rules. For more information, see Tagging rules.

Click Add tag to continue adding tags. Each bucket can have up to 50 tags.

Save your settings by clicking Save.

Deleting a tag

In the left navigation pane, click Buckets. Then, navigate to the Bucket tagging page by doing the following:

On the Buckets page, hover over the tag icon in the Tag column of the bucket you want to configure. Then, click the edit icon that appears.

On the Buckets page, click the name of the bucket. In the left navigation pane, select Basic configurations > Bucket tagging.

Click Edit, then click Delete in the Actions column of the tag you want to remove.

Save your settings by clicking Save.

Once a tag is deleted, the system immediately removes it from the bucket.

Editing a tag

In the left navigation pane, click Buckets. Then, navigate to the Bucket tagging page by doing the following:

On the Buckets page, hover over the tag icon in the Tag column of the bucket you want to configure. Then, click the edit icon that appears.

On the Buckets page, click the name of the bucket. In the left navigation pane, select Basic configurations > Bucket tagging.

Click Edit, then modify the Bucket tag key and Bucket tag value.

tip

The tag key and value must follow certain rules. For more information, see Tagging rules.

Save your settings by clicking Save.

Last updated: 2026.07.01 14:48:56