对象标签

最近更新时间:2021-05-21 14:55:04

查看PDF

KS3支持使用对象标签(Object Tagging)对存储的对象(Object)进行分类,您可以针对指定标签的Object设置生命周期规则。

说明:对象标签功能目前处于公测期,公测期间免费,公测期结束后使用对象标签会产生一定的费用,计费方式参考:计费方式和计量项说明

对象标签使用一组键值对(Key-Value)标记对象,您可以在上传文件时添加标签,也可以为现有文件添加标签。

每个对象最多添加10个标签。

Key命名规则

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

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

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

value设置规则

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

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

  • 只有Bucket拥有者和授权用户拥有读写对象标签的权限。
  • 跨区域复制时,对象标签也会复制到目的端。

使用场景

对象标签不受文件目录限制,您可以批量操作拥有指定标签的对象,例如:

  • 设置针对指定标签的生命周期规则。例如,周期性生成的非长期保存的文件,可以在上传时设置指定的标签,之后通过生命周期规则,将拥有这个标签的文件定期删除。

使用说明

对象标签涉及的API接口

  • PutObjectTagging:设置对象的标签。若对象已有标签,则覆盖原标签。
  • GetObjectTagging:读取对象的标签。
  • DeleteObjectTagging:删除某个对象关联的标签。
  • PutObject:用户可在上传对象时通过x‑kss‑tagging请求头指定对象标签。
  • PostObject:用户可在表单上传对象时通过tagging指定对象标签。
  • InitiateMultipartUpload:用户可在初始化分片上传时,通过x‑kss‑tagging请求头指定对象标签。
  • PutObjectCopy:复制对象时可通过x-kss-tagging-directive设置是否覆盖源对象标签,x‑kss‑tagging请求头指定目标对象标签。
  • PutObjcetFetch:用户拉取文件,并上传至KS3某个 bucket 中,可通过 x‑kss‑tagging请求头指定目标对象标签。
  • GetObject:当用户拥有读取对象标签的权限时,响应头中会带有x‑kss‑tagging‑count标识对象的标签个数。
  • HeadObject:当用户拥有读取对象标签的权限时,响应头中会带有x‑kss‑tagging‑count标识对象的标签个数。

对象标签涉及的控制台操作:

对象标签涉及的SDK文档:

权限说明

能够进行Tag相关操作的用户、角色、服务,必须具有如下相关权限,您可以通过Bucket policy 与IAM 实现如下权限授权管理:

  • GetObjectTagging:获取对象标签的权限。拥有此权限,可以查看到文件的已有标签。
  • PutObjectTagging:设置对象标签的权限。拥有此权限,可以为文件设置标签。
  • DeleteObjectTagging:删除对象标签的权限。拥有此权限,可以删除文件的标签。

例如:

  • 当为已经存在的对象设置标签或者通过上传时指定对象的标签,您需要具有 PutObjectTagging权限
  • 当您通过CopyObject接口, 复制一个带有标签的对象,
    您需要同时具有:
    • 源文件权限的GetObject, GetObjectTagging权限
    • 目标文件权限PutObject, PutObjectTagging,权限
  • 但是如果指定x-kss-tagging-directive为REPLACE且新指定tag为空, 则目标权限只需PutObject权限即可
  • 删除对象上标签,您需要具有DeleteObjectTagging权限
  • 但是若您删除对象则会将对象附属标签自动删除,您仅需DeleteObject权限

更多接口权限细节请参考,对象标签涉及的API接口

对象标签和生命周期管理

在生命周期规则配置中,您可以指定生命周期规则生效的条件。生命周期规则可针对前缀或对象标签生效,您也可以同时指定两者作为条件。

  • Tag条件中,标签的Key和Value必须同时匹配。
  • 同一个规则中,若同时配置了前缀和多个对象标签,则对象需满足前缀且同时匹配规则中所有对象标签,才视为适用于该规则。

示例:

<LifecycleConfiguration>
  <Rule>
    <ID>1</ID>
    <Filter>
       <And>
          <Prefix>documents</Prefix>
          <Tag>
             <Key>age</Key>
             <Value>21</Value>
          </Tag>
          <Tag>
            <Key>name</Key>
            <Value>li</Value>
           </Tag>
       </And>
    </Filter>
    <Status>Enabled</Status>
    <Expiration>
        <Days>30</Days>
    </Expiration>
  </Rule>
  <Rule>
    <ID>2</ID>
      <Filter>
            <And>
               <Prefix>pic</Prefix>
               <Tag>
                  <Key>age</Key>
                  <Value>20</Value>
               </Tag>
            </And>
         </Filter>
    <Status>Enabled</Status>
    <Transition>
        <Days>60</Days>
        <StorageClass>Archive</StorageClass>
    </Transition>
  </Rule>
</LifecycleConfiguration>

以上规则中:

  • 以documents为前缀且同时拥有标签age=21和name=li的对象在30天后被删除。
  • 以pic为前缀且拥有标签age=20的对象在60天后被转换为Archive(归档存储)。

说明: 更多信息请参见管理文件生命周期

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

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

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

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

更多建议

0/200

评价建议不能为空

提交成功!

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

问题反馈