tencent cloud

Cloud Object Storage

Release Notes and Announcements
Release Notes
Announcements
Product Introduction
Overview
Features
Use Cases
Strengths
Concepts
Regions and Access Endpoints
Specifications and Limits
Service Regions and Service Providers
Billing
Billing Overview
Billing Method
Billable Items
Free Tier
Billing Examples
Viewing and Downloading Bill
Payment Overdue
FAQs
Getting Started
Console
Getting Started with COSBrowser
User Guide
Creating Request
Bucket
Object
Data Management
Batch Operation
Global Acceleration
Monitoring and Alarms
Operations Center
Data Processing
Content Moderation
Smart Toolbox
Data Processing Workflow
Application Integration
User Tools
Tool Overview
Installation and Configuration of Environment
COSBrowser
COSCLI (Beta)
COSCMD
COS Migration
FTP Server
Hadoop
COSDistCp
HDFS TO COS
GooseFS-Lite
Online Tools
Diagnostic Tool
Use Cases
Overview
Access Control and Permission Management
Performance Optimization
Accessing COS with AWS S3 SDK
Data Disaster Recovery and Backup
Domain Name Management Practice
Image Processing
Audio/Video Practices
Workflow
Direct Data Upload
Content Moderation
Data Security
Data Verification
Big Data Practice
COS Cost Optimization Solutions
Using COS in the Third-party Applications
Migration Guide
Migrating Local Data to COS
Migrating Data from Third-Party Cloud Storage Service to COS
Migrating Data from URL to COS
Migrating Data Within COS
Migrating Data Between HDFS and COS
Data Lake Storage
Cloud Native Datalake Storage
Metadata Accelerator
GooseFS
Data Processing
Data Processing Overview
Image Processing
Media Processing
Content Moderation
File Processing Service
File Preview
Troubleshooting
Obtaining RequestId
Slow Upload over Public Network
403 Error for COS Access
Resource Access Error
POST Object Common Exceptions
API Documentation
Introduction
Common Request Headers
Common Response Headers
Error Codes
Request Signature
Action List
Service APIs
Bucket APIs
Object APIs
Batch Operation APIs
Data Processing APIs
Job and Workflow
Content Moderation APIs
Cloud Antivirus API
SDK Documentation
SDK Overview
Preparations
Android SDK
C SDK
C++ SDK
.NET(C#) SDK
Flutter SDK
Go SDK
iOS SDK
Java SDK
JavaScript SDK
Node.js SDK
PHP SDK
Python SDK
React Native SDK
Mini Program SDK
Error Codes
Harmony SDK
Endpoint SDK Quality Optimization
Security and Compliance
Data Disaster Recovery
Data Security
Cloud Access Management
FAQs
Popular Questions
General
Billing
Domain Name Compliance Issues
Bucket Configuration
Domain Names and CDN
Object Operations
Logging and Monitoring
Permission Management
Data Processing
Data Security
Pre-signed URL Issues
SDKs
Tools
APIs
Agreements
Service Level Agreement
Privacy Policy
Data Processing And Security Agreement
Contact Us
Glossary
DocumentaçãoCloud Object StorageUser ToolsCOSCLI (Beta)Common CommandsObject Tag - object-tagging

Object Tag - object-tagging

PDF
Modo Foco
Tamanho da Fonte
Última atualização: 2025-10-28 15:46:31
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


Anterior: Bucket Versioning - bucket-versioningPróximo: Managing Bucket ACL - bucket-acl

Ajuda e Suporte

Esta página foi útil?

comentários