putObjectTagging method
Written by
Updated at September 2, 2025
Adds labels to a bucket object. This overwrites any existing object labels.
Note
Yandex Cloud uses labels to logically identify resources. However, Object Storage supports compatibility with Amazon S3 API, that is why we use tags, a term native to AWS, in the AWS CLI commands and API parameters.
For more information on getting started with the API and the general request format, see How to use the S3 API.
Request
PUT /{bucket}/{key}?tagging&versionId={versionId} HTTP/2
Path parameters
| Parameter | Description |
|---|---|
bucket |
Bucket name. |
key |
Object key. |
Request parameters
| Parameter | Description |
|---|---|
tagging |
Type of operation. This is a required parameter. |
versionId |
Object version ID. This is a required parameter. |
Data schema
<?xml version="1.0" encoding="UTF-8" ?>
<ListBucketResult
xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<KeyCount>1</KeyCount>
<Name>my-sample-bucket</Name>
<Prefix></Prefix>
<MaxKeys>1000</MaxKeys>
<IsTruncated>false</IsTruncated>
<Contents>
<Key>text.txt</Key>
<LastModified>2025-05-15T07:23:08.030Z</LastModified>
<Owner>
<ID>ajegtlf2q28a********</ID>
<DisplayName>ajegtlf2q28a********</DisplayName>
</Owner>
<ETag>"f75a361db63aa4722fb8e083********"</ETag>
<Size>103</Size>
<StorageClass>STANDARD</StorageClass>
<TagSet></TagSet>
</Contents>
</ListBucketResult>
| Element | Description |
|---|---|
Tagging |
Root element. |
TagSet |
Array of labels. |
Tag |
Container for a label. |
Key |
Label key. Type: String. |
Value |
Label value. Type: String. |
Headers
Use only common headers in your requests.
Response
Headers
In addition to common 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.