PutObjectTagging method
Written by
Updated at July 14, 2023
Adds labels to a bucket object. This overwrites any existing object labels.
Note
In Yandex Cloud terminology, we use the label concept to denote logical resource labeling. However, as Object Storage is compatible with Amazon S3 API
Query
PUT /{bucket}/{key}?tagging&versionId={versionId} HTTP/2
Path parameters
Parameter | Description |
---|---|
bucket |
Bucket name. |
key |
Object key. |
Query parameters
Parameter | Description |
---|---|
tagging |
Type of operation. This parameter is required. |
versionId |
Object version ID. This parameter is required. |
Data schema
<?xml version="1.0" encoding="UTF-8" ?>
<Tagging xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<TagSet>
<Tag>
<Key>string</Key>
<Value>string</Value>
</Tag>
</TagSet>
</Tagging>
Element | Description |
---|---|
Tagging |
Root element. |
TagSet |
Array of labels. |
Tag |
Container for labels. |
Key |
Label key. Type: String. |
Value |
Label value. Type: String. |
Headers
Use only common request headers in your requests.
Response
Headers
In addition to common response headers, responses may contain:
Header | Description |
---|---|
x-amz-version-id |
Object version ID. |
Response codes
For a list of possible responses, see Responses.
A successful response does not contain any additional data.