You need to enable JavaScript to run this app.
导航

设置对象元数据(setmeta)

最近更新时间2024.02.29 20:16:16

首次发布时间2022.11.03 10:30:29

您可以通过 setmeta 命令设置对象元数据。

命令格式

  • 设置单个对象元数据

    ./tosutil setmeta tos://bucket/key [-versionId=xxx] [-meta=aaa:bbb#ccc:ddd] [-contentType=xxx] [-contentDisposition=xxx] [-contentEncoding=xxx] [-contentLanguage=xxx] [-cacheControl=xxx] [-expires=xxx] [-fr] [-o=xxx] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]
    
  • 批量设置对象元数据

    ./tosutil setmeta tos://bucket/[prefix] -r [-j=1] [-meta=aaa:bbb#ccc:ddd] [-contentType=xxx] [-contentDisposition=xxx] [-contentEncoding=xxx] [-contentLanguage=xxx] [-cacheControl=xxx] [-expires=xxx] [-o=xxx] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]
    

参数说明

通用可选参数的说明,请参见通用可选参数

参数名

参数类型

描述

bucket

String

桶名。

key

String

对象名。

prefix

String

批量操作时的对象名前缀。

-r

Bool

执行批量设置对象元数据操作。

-j

Integer

批量设置对象元数据的最大并发数,默认为配置文件中的 defaultJobs

-versionId

String

待设置对象元数据的单个对象的版本号。

-meta

String

设置对象的自定义元数据。

-contentType

String

设置对象的 Content-Type。

-contentDisposition

String

设置对象的 Content-Disposition。

-contentEncoding

String

设置对象的 Content-Encoding。

-contentLanguage

String

设置对象的 Content-Language。

-cacheControl

String

设置对象的 Cache-Control。

-expires

String

设置对象的 Expires,格式为:YYYYMMDDHHmmSS。

-fr

Bool

设置单个对象元数据时生成结果清单文件。

-o

String

生成结果清单文件的文件夹,默认为配置文件中的 defaultOutputDir

使用示例

设置单个对象元数据

以下命令用于将 bucketname 桶内的 object1.png 对象的自定义元数据设置为 aaa:bbb#ccc: ddd

  • 命令

    ./tosutil setmeta tos://bucketname/object1.png -meta aaa:bbb#ccc:ddd
    
  • 返回

    Start at 2022-10-27 08:30:54.714864 +0000 UTC
     
    Set object metadata [object1.png] in the bucket [bucketname] successfully, cost [162], request id [d6c8485a41be2c6f635a41be-ac1424b7-1onyHu-SOM-cb-tos-bj]
    

批量设置对象元数据

以下命令用于将 bucketname 桶内所有前缀为 object 的对象的自定义元数据设置为 aaa:bbb#ccc: ddd

  • 命令

    ./tosutil setmeta tos://bucketname/object -r -meta aaa:bbb#ccc:ddd
    
  • 返回

    Start at 2022-10-27 08:31:45.565285 +0000 UTC
     
    [--------------------------------------------------] 100.00% tps:0.00 3/3 161ms
    Succeed count is:   3         Failed count is:    0         
    Metrics [max cost:108 ms, min cost:36 ms, average cost:75.33 ms, average tps:18.63]
     
    Task id is: cac32e78-55d1-11ed-936d-aa665a3c7f26