Obtaining the Tags of an Object

Function

You can use this command to obtain the tags of an object.

Constraints

To obtain the tags of an object, you must be the object owner or have the required permission (obs:bucket:GetObjectTagging granted using IAM or GetObjectTagging granted using a bucket policy). For details, see Differences Between OBS Permissions Control Methods, Using IAM Roles or Policies to Grant Access to OBS, and Creating a Custom Bucket Policy.

Command Line Structure

• Windows

  obsutil object-tagging obs://bucket -method=get [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

• macOS or Linux

  ./obsutil object-tagging obs://bucket -method=get [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

Examples

• In Windows, run obsutil object-tagging obs://test-bucket/key -method=get to obtain the tag configuration of object key in the test-bucket bucket.

  obsutil object-tagging obs://test-bucket/key -method=get
  
  Start at 2024-09-30 07:59:28.8675681 +0000 UTC
  
  Index                    Tag Key             Tag Value
  0                        key1                value1
  
  1                        key2                value2
  Get tagging object [key] in the bucket [test-bucket] successfully, cost [2416] ms, request id [0000019AB625548A4015EF40BDBFDD61]

Parameter Description

Helpful Links

• For details about the API for obtaining object tags, see Obtaining Object Tags.
• For details about the meanings, causes, and handling methods of error codes that may be returned during the operation, see OBS Error Codes.