tencent cloud

Object Tag - object-tagging
Download PDF
Last updated: 2025-10-28 15:46:31
Object Tag - object-tagging
Last updated: 2025-10-28 15:46:31
Download PDF
The object-tagging command is used to create (modify), query, and delete object tags. Each object supports up to 10 group tags.
Note:
To query object tags, when you perform authorization policy, set the action to cos:GetObjectTagging.
To set object tags, when performing authorization policy, set the action to cos:PutObjectTagging.
To delete object tags, when performing authorization policy, set the action to cos:DeleteObjectTagging.
For more authorization, please refer to business APIs that support CAM.

Command Syntax

./coscli object-tagging --method [method] cos://<bucket-name>/object [tag_key]#[tag_value]
The object-tagging command includes the following parameters:
Parameter Format
Description
Example
cos://<bucket-name>
Specify the target bucket. Supports using the bucket alias or bucket name in configuration parameters. If using the bucket name for access, you must also carry the endpoint flag.
Access with the bucket alias: cos://example-alias
Access with the bucket name: cos://examplebucket-1250000000
The object-tagging command includes the following optional flags:
Flag Abbreviation
Flag Name
Description
-h
--help
Views the usage of this command.
None
--method
Specify the operation to perform, including put (set tag), get (query tag), delete (delete tag), and add (add tag).
None
--version-id
Specified version of the operation object
Note:
For more general options for this command (such as switching buckets or user accounts), see Common Options.

Modifying Object Tags

Object tags are represented by a set of Key-Value pairs. Only the object owner and users with PutObjectTagging permissions can add or modify object tags. Otherwise, error code 403 AccessDenied will be returned.

Command Syntax

./coscli object-tagging --method put cos://bucketAlias/object key1#value1 key2#value2
Among them, key#value represents the tag key-value pair Key-Value, where key and value are separated #. If the object has no tags, this command will add the designated tags to the object. If the object already has tags, this command will overwrite the original tags.

Operation Example

Configure two group tags for the object under bucket alias example-alias. Among them, one group tag has key 1 and value 111, the other group tag has key 2 and value 222. The command is as follows:
./coscli object-tagging --method put cos://example-alias/object 1#111 2#222

GET Object tagging

Command Syntax

./coscli object-tagging --method get cos://bucketAlias/object

Operation Example

./coscli object-tagging --method get cos://example-alias/object
The output result shows the object under bucket alias example-alias is configured with two group tags. Among them, one tag has key 1 and value 111, the other has key 2 and value 222.
  KEY | VALUE  
------+--------
    1 |   111  
    2 |   222

Deleting Object Specified Tag

Command Syntax

./coscli object-tagging --method delete cos://bucketAlias/object key1#value1

Operation Example

./coscli object-tagging --method delete cos://example-alias/object 1#111

Deleting ALL Object Tags

Command Syntax

./coscli object-tagging --method delete cos://bucketAlias/object

Operation Example

./coscli object-tagging --method delete cos://example-alias/object

Adding Object Tags

Object tags are represented by a set of Key-Value pairs. Only the object owner and users with PutObjectTagging permissions can add or modify object tags. Otherwise, error code 403 AccessDenied will be returned.

Command Syntax

./coscli object-tagging --method add cos://bucketAlias/object key3#value3
Among them, key#value represents the tag key-value pair Key-Value, where key and value are separated by #.

Operation Example

Add a group tag to the object under bucket alias example-alias. The tag has key 1 and value 111. The command is as follows:
./coscli object-tagging --method add cos://example-alias/object 1#111


Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback