All Documents
Current Document

Recommend

Container Engine Virtual Private Cloud Standard Storage Service

Found 0 result in total

Content is empty

If you don't find the content you expect, please try another search term

Documentation

Standard Storage Service (KS3)

View more results
Document title with current keyword not found
Directory
Expand AllFold All Up
No products found with this keyword
Documentation Standard Storage Service (KS3) API Reference Object operations Get Object Tagging

Get Object Tagging

Last updated：2021-09-14 16:18:18

You can call this operation to query the tags of an object.

Permission

To call this operation, you must have the GetObjectTagging permission on the object. KS3 returns corresponding information based on whether you have the GetObjectTagging permission. If you do not have the GetObjectTagging permission on the object, KS3 returns an HTTP 403 error with the error message "access denied."

Request syntax

GET /<ObjectKey>?tagging HTTP 1.1
Host:<BucketName>.<Region>.ksyuncs.com
Date: GMT Date
Authorization: Auth String

References:

Request headers

A GetObjectTagging request contains only common request headers. For more information, see common request headers.

Response headers

The response to a GetObjectTagging request contains only common response headers. For more information, see common response headers.

Response elements

Element Type Description
Tagging Container The collection of tags.Child node: TagSet
TagSet Container The collection of tags.
Parent node: Tagging.
Child node: Tag
Tag Container The collection of tags.
Parent node: TagSet.
Child nodes: Key and Value
Key String The key of the object tag.
Parent node: Tag.
Child node: none
Value String The value of the object tag.
Parent node: Tag.
Child node: none

Special errors

No special errors are returned.

Examples

  • Sample request
GET /<ObjectKey>?tagging HTTP 1.1
Host:<BucketName>.<Region>.ksyuncs.com
Date: GMT Date
Authorization: Auth String
  • Sample response
HTTP/1.1 200 OK
Content-Type: application/xml
Connection: close
Date: Fri, 19 Jan 2020 11:40:22 GMT
Server: ks3
<Tagging>
    <TagSet>
        <Tag>
            <Key>age</Key>
            <Value>18</Value>
        </Tag>
        <Tag>
            <Key>name</Key>
            <Value>xiaoming</Value>
        </Tag>
    </TagSet>
</Tagging>
On this page
Previous:Delete Object Tagging
Next:Put Object Tagging
Pure ModeNormal Mode

Pure Mode

Click to preview the document content in full screen
Feedback