Object Tag Overview

Last Updated At: 2025-11-26 15:01:22

Feature Overview

The object tagging feature is used to help you group and manage objects in your bucket by adding a key-value pair as an identifier for objects. An object tag consists of a tag key (tagKey), a tag value (tagValue), and an equal sign =, for example, group = IT. You can set, query, and delete tags for a specified object.

Usage Instructions

Using the COS Console

You can manage object tags via the COS console.

Using the REST API

You can manage object tags via the following APIs:

Specifications and Limits

Limits on Tag Keys

  • Tag keys can contain characters encoded in UTF-8, spaces, digits [0–9], and special characters including + - = ._ : / @.
  • Tag keys can contain 1 to 127 characters (encoded in UTF-8).
  • Tag keys are case-sensitive.

Limits on Tag Values

  • Tag values can contain characters encoded in UTF-8, spaces, digits [0–9], and special characters including + - = ._ : / @.
  • Tag values can contain 1 to 255 characters (encoded in UTF-8).
  • Tag values are case-sensitive.

Limits on the Number of Tags

  • Object dimension: Up to 10 different object tags per object.
  • Tag dimension: unlimited.