tencent cloud

All product documents
Cloud Object Storage
DocumentationCloud Object StorageUser ToolsCOSCLI (Beta)Common CommandsTagging Bucket - bucket-tagging
Tagging Bucket - bucket-tagging
Download PDF
Last updated: 2024-01-06 16:15:35
Tagging Bucket - bucket-tagging
Last updated: 2024-01-06 16:15:35
Download PDF
The bucket-tagging command is used to create (modify), get, and delete bucket tags. One bucket can have up to 50 tags.

Command Syntax

./coscli bucket-tagging --method [method] cos://<bucket-name> [tag_key]#[tag_value]
bucket-tagging includes the following parameters:
Parameter Format
Description
Example
cos://<bucket-name>
Specifies the target bucket, which is accessible by using the bucket alias or bucket name configured in the configuration file as detailed in Download and Installation Configuration. If you use the bucket name for access, you also need to include the endpoint flag.
Access with the bucket alias: cos://example-alias
Access with the bucket name: cos://examplebucket-1250000000
The bucket-tagging command contains the following optional flags:
Flag Abbreviation
Flag Name
Description
-h
--help
Views the usage of this command.
None
--method
Specifies the operation to be performed, including put (adding tags), get (querying tags), and delete (deleting tags).
Note:
For other common options of this command (such as switching bucket and user account), see Common Options.

Adding or Modifying Bucket Tag

A bucket tag is represented by a key-value pair. Only the bucket owner and users with the PutBucketTagging permission can add or modify bucket tags. Error message “403 AccessDenied” will be returned for other users.

Command syntax

./coscli bucket-tagging --method put cos://bucketAlias key1#value1 key2#value2
Here, key#value represents the tag key-value pair separated by #. If the bucket does not have a tag, this command will add the specified tag to the bucket; otherwise, it will overwrite the original tag.

Example

To configure two tags with the keys of 1 and 2 as well as values of 111 and 222 respectively for the bucket with alias example-alias, run the following command:
./coscli bucket-tagging --method put cos://exmaple-alias 1#111 2#222

Querying Bucket Tags

Command syntax

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

Example

./coscli bucket-tagging --method get cos://exmaple-alias
The following output shows that the bucket with alias example-alias has two tags with the keys of 1 and 2 as well as values of 111 and 222 respectively.
  KEY | VALUE  
------+--------
    1 |   111  
    2 |   222

Deleting Bucket Tags

Command syntax

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

Example

./coscli bucket-tagging --method delete cos://exmaple-alias

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

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Contact Us
Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 available.

Submit a Ticket
7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon