设置对象元数据（setmeta）--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

设置对象元数据（setmeta）

最近更新时间：2024.02.29 20:16:16首次发布时间：2022.11.03 10:30:29

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

命令格式

Linux/macOS

Windows

设置单个对象元数据

./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]

设置单个对象元数据

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