PutObjectTagging
更新时间 2026-04-10 20:11:11
最近更新时间: 2026-04-10 20:11:11
功能说明
PutObjectTagging为存储桶中已存在的对象设置标签。
注意事项
标签是一个键值对。请注意，标签的最大数量限制为每个对象10个标签。要使用此操作，您必须具有执行s3:PutObjectTagging操作的权限。 默认情况下，Bucket拥有者拥有此权限，并且可以将此权限授予其他人。要放置任何其他版本的标签，请使用versionId查询参数。 您还需要s3:PutObjectVersionTagging 操作的权限。
请求消息样式
PUT /{Bucket}/{Key}?tagging&versionId={VersionId} HTTP/1.1
Host: xxx.zos.ctyun.cn
Accept-Encoding: identity
Date: Tue, 12 Apr 2022 11:03:15 GMT
Content-Length: 131
Content-MD5: PETM1O0IztxMJvOLEU3nwQ==
Authorization: string
<Tagging>
<TagSet>
<Tag>
<Key>string</Key>
<Value>string</Value>
</Tag>
</TagSet>
</Tagging>请求消息参数
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释： Bucket的名称。 | String | 是 |
| Key | 参数解释： Object的名称。 | String | 是 |
| versionId | 参数解释： 多版本场景下，指定对象的特定版本。不指定时，默认为最新版本的Id，如存在null版本号，并需对其操作，则需指定VersionId='null'。VersionId=''等效于指定最新版本的Id。 | String | 否 |
请求消息头
该请求使用公共的请求消息头，请参见如何调用API-构造请求-请求消息头。
请求消息元素
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Tagging | 参数解释： 标签集容器，内部为标签列表，最多10个标签，每个标签都是键值对，key最大128字节，value最大256字节，value可以为空，key和value均为utf-8编码。 | Container | 是 |
表 Tagging
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| TagSet | 参数解释： 标签集合。 | Container | 是 |
表 TagSet
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Tag | 参数解释： 单个标签。 | Container | 是 |
表 Tag
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Key | 参数解释： 标签键。 | String | 是 |
| Value | 参数解释： 标签值。 | String | 是 |
响应消息样式
HTTP/1.1 Status Code
x-amz-request-id: tx00000000000000000001a-0062555c74-34455-default
Content-Type: application/xml
Content-Length: 0
Date: Tue, 12 Apr 2022 11:03:16 GMT
Connection: Keep-Alive响应消息头
该请求的响应消息使用公共的响应消息头，请参见如何调用API-响应结果-响应消息头。
响应消息元素
该请求的响应中不带有响应元素。
错误码
请参见调用前必知-错误码-全局错误码。
