tencent cloud

Feedback

Tagging Bucket - bucket-tagging

Last updated: 2022-05-09 14:18:32

    The bucket-tagging command is used to create (modify), get, and delete bucket tags.

    Command Options

    The bucket-tagging command contains the following optional flags:

    Flag Abbreviation Flag Name Description
    -m --method Specifies the operation to be performed, including PUT, GET, and DELETE
    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 format

    ./coscli bucket-tagging --method put cos://<BucketName-APPID> 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 for the bucket exmaplebucket-1250000000 with the keys of 1 and 2 as well as values of 111 and 222 respectively, run the following command:

    ./coscli bucket-tagging --method put cos://exmaplebucket-1250000000 1#111 2#222
    

    Querying Bucket Tags

    Command format

    ./coscli bucket-tagging --method get cos://<BucketName-APPID>
    

    Example

    ./coscli bucket-tagging --method get cos://exmaplebucket-1250000000
    

    The following output shows that exmaplebucket-1250000000 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 format

    ./coscli bucket-tagging --method delete cos://<BucketName-APPID>
    

    Example

    ./coscli bucket-tagging --method delete cos://exmaplebucket-1250000000
    
    Contact Us

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

    Technical Support

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

    7x24 Phone Support