Put Object Tagging

最近更新时间:2021-04-07 20:13:07

查看PDF

PutObjectTagging接口用于设置或更新对象(Object)的标签(Tagging)信息。

注意事项

对象标签使用一组键值对(Key-Value)标记对象。调用PutObjectTagging接口时,有如下注意事项:

  • 单个Object最多可设置10个标签,Key不可重复。

    Key命名规则

    • 支持大小写字母、数字、空格和符号 + - = . _ : /

    • 1-128字节,区分大小写,不能以空格开头或结尾,不容许为空

    • 不容许设置系统保留字段,ksc:与kss:开头

    value设置规则

    • 支持大小写字母、数字、空格和符号 + - = . _ : /

    • 1-256字节,区分大小写,不能以空格开头或结尾

  • 更改标签信息不会更新Object的Last‑Modified时间。

通过HTTP header的方式设置标签且标签中包含任意字符时,您需要对标签的Key和Value做URL编码。

有关对象标签的更多信息,请参见对象标签

权限

该接口操作需要用户对Object拥有PutObjectTagging权限。KS3将根据你是否拥有写权限返回相应信息。
如果你并不拥有该Object的PutObjectTagging权限,KS3将会返回的 HTTP 状态码为403(access denied)错误。

请求语法

PUT /<ObjectKey>?tagging HTTP 1.1
Host:<BucketName>.<Region>.ksyun.com
Date: GMT Date
Authorization: Auth String
<Tagging>
    <TagSet>
        <Tag>
            <Key>string</Key>
            <Value>string</Value>
        </Tag>
    </TagSet>
</Tagging>    

请求元素

名称 类型 是否必需 描述
Tagging 容器 标签集合。
子节点:TagSet
TagSet 容器 标签集合。
父节点:Tagging
子节点:Tag
Tag 容器 标签集合。
父节点:TagSet
子节点:Key、Value
Key 字符串 标签键。长度不超过128字节,支持大小写英文字母、数字、空格、加号、减号、下划线、等号、点号、冒号、正斜线、反斜线。
父节点:Tag
子节点:无
Value 字符串 标签值。长度不超过256字节,支持大小写英文字母、数字、空格、加号、减号、下划线、等号、点号、冒号、正斜线、反斜线
父节点:Tag
子节点:无

示例

  • 请求示例

    针对存储空间BucketName中的对象ObjectKey,通过PUT请求设置{name:1}和{age:2}两个标签。标签设置成功后返回200 (OK)。

    PUT /<ObjectKey>?tagging HTTP 1.1
    Host:<BucketName>.<Region>.ksyun.com
    Date: GMT Date
    Authorization: Auth String
    <Tagging>
      <TagSet>
        <Tag>
          <Key>name</Key>
          <Value>1</Value>
        </Tag>
        <Tag>
          <Key>age</Key>
          <Value>2</Value>
        </Tag>
      </TagSet>
    </Tagging>
    

    返回示例

    HTTP/1.1 200 OK
    Date: Fri, 26 Dec 2020 06:34:32 GMT
    x-kss-request-id: dbea4ce4ec23415b9e454ecfa25e****
    Content-Length: 0
    Server: Tengine
    

错误码说明

错误码 描述 HTTP状态码
SignatureDoesNotMatch 提供的签名不符合规则,返回该错误码 403 Forbidden
TNoSuchObject 如果对象不存在,则无法添加对象标签,将返回该错误码 404 Not Found
MalformedXML XML 格式不合法,请跟 Restful API 文档仔细比对 400 Bad Request
InvalidTag Tag 的 key 和 value 中包含了保留字符串ksc:与kss: 400 InvalidTaggingFormat
BadRequest 超过了一个对象允许设置标签数量的最大值,目前最多支持10个标签 400 Bad Reques

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

  • 内容不全,不深入
  • 内容更新不及时
  • 描述不清晰,比较混乱
  • 系统或功能太复杂,缺乏足够的引导
  • 内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈