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

SetObjectMeta

最近更新时间2024.01.15 15:20:42

首次发布时间2021.10.13 16:14:08

此接口用于更新已经上传对象的元数据信息。TOS 支持携带以下 6 个请求头来修改对象元数据,在下载对象或者 HEAD 对象时,这些值会设置到 HTTP 头域中返回给客户端。支持的 6 个头域:Cache-ControlContent-DispositionContent-EncodingExpiresContent-TypeContent-Language
该接口会完整替换对象元数据,未指定的元数据会被删除。

注意事项

使用 SetObjectMeta 接口更新归档存储、冷归档存储和深度冷归档存储对象的元数据前,需要先恢复对象。

请求消息样式

POST /ObjectName?metadata HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: GMT Date
Authorization: authorization string
<Optional Additional Header>

请求参数和消息头

该请求使用的公共请求消息头,请参见公共参数

名称

位置

参数类型

是否必选

示例值

说明

metadata

Query

String

代表 SetObjectMeta 请求的特殊标识。

versionId

Query

String

57AF1A32CECB56721267

对象的版本号。标识更改指定版本的对象自定义元数据。

Content-Type

Header

String

text/plain

对象类型。

Cache-Control

Header

String

no-cache, no-store, must-revalidate

指定该对象被下载时网页的缓存行为。

Expires

Header

String

Mon, 04 Jul 2022 02:57:31 GMT

RFC2616 中定义的缓存失效时间。

Content-Disposition

Header

String

attachment; filename=123.txt

对象被下载时的名称。

Content-Encoding

Header

String

gzip

对象被下载时的内容编码类型。

Content-Language

Header

String

en-US

对象被下载时的内容语言格式。

x-tos-meta-*

Header

String

x-tos-meta-key: value

创建对象时,可以在 HTTP 请求中加入以 x-tos-meta-开头的消息头,用来加入自定义的元数据,以便对对象进行自定义管理。当用户获取此对象或查询此对象元数据时,加入的自定义元数据将会在返回消息的头中出现。

请求元素

该请求中无请求消息元素。

响应消息头

该请求返回公共响应消息头,请参见公共参数

响应元素

该请求响应中无消息元素。

请求示例 1

给对象添加元数据Content-Type: application/x-www-form-urlencoded x-tos-meta-test: meta-test

POST /ObjectName?metadata HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 GMT
Authorization: authorization string
Content-Type: application/x-www-form-urlencoded
x-tos-meta-test: meta-test

响应示例 1

HTTP/1.1 200 OK
x-tos-id-2: f91b0c03a01300c1-a444ed0
x-tos-request-id: f91b0c03a01300c1-a444ed0
Date: Fri, 30 Jul 2021 08:05:36 GMT
server: TosServer
Content-Length: 0

请求示例 2

修改对象元数据,已经存在Content-Type: application/x-www-form-urlencoded和x-tos-meta-test: meta_test,修改为x-tos-meta-test: meta_modify

POST /ObjectName?metadata HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 GMT
Authorization: authorization string
Content-Type: application/x-www-form-urlencoded
x-tos-meta-test: meta_modify

响应示例 2

HTTP/1.1 200 OK
x-tos-id-2: 92ab6a0bb2ff0006-a444ed0
x-tos-request-id: 92ab6a0bb2ff0006-a444ed0
Date: Fri, 30 Jul 2021 08:05:36 GMT
server: TosServer
Content-Length: 0