最近更新时间：2025-04-08 18:04:43
该接口用于为存储空间添加或修改标签。使用此接口，必须是Bucket的所有者或具有ks3:PutBucketTagging权限。
1. 如果存储空间已经存在标签配置，新添加的标签将全部覆盖旧标签，请注意这一点以免误删。如果想要增加而不是覆盖标签，可以先通过GetBucketTags获取已有标签后，在已有标签的基础上叠加标签进行设置。
2. 为避免出错，推荐在KS3控制台进行标签设置，更加简单高效。
PUT /?tagging HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
Content-length: {length}
Content-MD5: {md5}
Tagging in the request body名称 | 类型 | 是否必填 | 描述 |
Tagging | 容器 | 是 | 设置存储空间TagSet的容器。
|
TagSet | 容器 | 是 | 包含一系列存储空间Tag的容器。
|
Tag | 容器 | 是 | 设置Bucket Tag的容器。
|
Key | 字符串 | 是 | 指定存储空间 Tag的Key。未预设标签时，支持直接创建标签并绑定桶。 最大长度为128字符，仅支持中英文字符、数字及+-=._:/@”，大小写敏感不能为空。
|
Value | 字符串 | 否 | 指定存储空间Tag的Value。 最大长度为256字符仅支持中英文字符、数字及
|
该接口除公共请求头外，还需要以下请求头：
名称 | 描述 | 是否必选 |
|---|---|---|
Content-MD5 | Body里Data的128位MD5 Digest，再用Base64编码。这个Header必须存在，以便检查Body是否损坏。详见RFC-1864
| 是 |
该接口仅涉及常用响应头部。
该接口不返回响应内容。
PUT /?tagging HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Date: Wed, 14 May 2014 02:11:21 GMT
Content-MD5: xxx
Authorization: authorization string
Content-Length: yyy
Content-type: application/xml
<Tagging>
<TagSet>
<Tag>
<Key>Keya</Key>
<Value>Valuea</Value>
</Tag>
<Tag>
<Key>keya</Key>
<Value>Valuea</Value>
</Tag>
</TagSet>
</Tagging>HTTP/1.1 200 OK
Content-Length: 0
Connection: keep-alive
Date: Tue, 19 Jul 2017 09:14:23 GMT
Server: KS3
x-kss-request-id: 54a47bda18ac4e6e91de369add54218***错误码 | HTTP状态码 | 描述 |
InvalidArgument | 400 Bad Request | Key为空 |
InvalidArgument | 400 Bad Request | Key、Value超过最大长度或存在非法字符 |
AccessDenied | 403 AccessDenied | 没有 |
纯净模式
