有奖捉虫:云通信与企业服务文档专题,速来> HOT
注意
您目前查阅的是历史版本 API 文档,后续不再更新和维护,我们建议您查阅新版 API 文档

功能描述

使用该 API 对腾讯云对象存储中某个文件的属性进行设置或修改。成功更新文件属性的前提条件是 Bucket 中已存在该文件。如果该 Bucket 中没有该文件请求不成功。
注意
1. 目前仅提供对authoritycustom_headers的更新操作,在更新时需要用flag来决定此次操作是更新authority还是custom_headers或者二者都更新。
2. 对于自定义头部custom_headers中的各属性值,均由用户来定义和维护,腾讯云对象存储不负责维护其属性值是否正确有效。

请求

语法示例:
POST /files/v2/100088888/test/sample_file.txt HTTP/1.1
Host: <Region>.file.myqcloud.com
Content-Length: <ContentLength>
Content-Type: application/json
Authorization: <OnceSignature>
说明
Authorization: <OnceSignature> 单次有效签名(详细参见 签名算法 章节)。
Content-Length: <ContentLength> RFC 2616 中定义的 HTTP 请求内容长度(字节)。

请求参数

该请求不带请求参数。

请求体

该 API 接口请求的请求体具体节点内容为:
{
"biz_attr": "demo",
"custom_headers": {
"x-cos-meta-yyy": "yyy",
"Content-Disposition": "ccccxxx.txt",
"Content-Language": "english",
"Cache-Control": "cache_xxx",
"Content-Type": "application/text",
"x-cos-meta-xxx": "xxx"
},
"authority": "eWRPrivate",
"op": "update"
}
具体内容描述如下:
参数名称
描述
类型
必选
biz_attr
COS 服务调用方自定义属性,可通过 查询目录属性 获取该属性值
String
custom_headers
用户自定义 header,在执行更新操作时,只需填写需要增加或修改的项
Object
authority
Object 的权限,默认与 Bucket 权限一致,此时不会返回该字段。如果设置了独立权限,则会返回该字段。 有效值:eInvalid(空权限),此时系统会默认调取 Bucket 权限,eWRPrivate(私有读写) ,eWPrivateRPublic (公有读私有写)
String
op
操作类型,填“update”
String
custom_headers 数据集参数描述:
参数名称
描述
类型
必选
x-cos-meta-yyy
用户自定义内容 yyy
String
Content-Disposition
MIME 协议的扩展
String
Content-Language
文件的语言
String
Cache-Control
文件的缓存机制
String
Content-Type
文件的 MIME 信息
String
x-cos-meta-xxx
用户自定义内容 xxx
String

响应

响应体

该响应体返回为 application/json 数据,包含完整节点数据的内容展示如下:
{
"message": "SUCCESS",
"code": 0,
"request_id": "NTk5YmRjNjZfNmNhZDM1MGFfOGE0MF9lZDA1MQ=="
}
具体的参数描述如下:
参数名称
描述
类型
code
服务端返回码,如果没有发生任何错误取值为0;如果发生错误该参数指称具体的错误码。COS 服务相关的错误码可以查看 COS 错误码
Number
request_id
该请求的唯一标识 ID
String
message
服务端提示内容,如果发生错误该字段将详细描述发生错误的情况。
String

实际案例

请求

POST /files/v2/1252448703/test02/sample_file.txt HTTP/1.1
Content-Length: 268
Accept-Encoding: gzip, deflate
Accept': */*
Connection: keep-alive
Content-Type: application/json
Authorization: W0o/dAf5RjYPqBOkFx+TVAw2PwhhPTEyNTI0NDg3MDMmaz1BS0lEMTVJc3NraUJRS1RaYkFvNldoZ2NCcVZsczlTbXVHMDAmZT0wJnQ9MTUwMzM4OTUwMyZyPTc1ODUyMTM3OSZmPS8xMjUyNDQ4NzAzL3Rlc3QwMi9zYW1wbGVfZmlsZS50eHQmYj10ZXN0MDI=

{
"biz_attr": "demo",
"custom_headers": {
"x-cos-meta-yyy": "yyy",
"Content-Disposition": "ccccxxx.txt",
"Content-Language": "english",
"Cache-Control": "cache_xxx",
"Content-Type": "application/text",
"x-cos-meta-xxx": "xxx"
},
"authority": "eWRPrivate",
"op": "update"
}

响应

HTTP/1.1 200 OK
Content-Length': 616
Content-Type: application/json; charset=utf-8
Server: tencent-cos
Connection: keep-alive
Date: Tue, 22 Aug 2017 07:35:36 GMT
x-cos-request-id: NTk5YmRlYzhfMmFhYzM1MGFfNzcwNF9mNTU0OQ==

{
"message": "SUCCESS",
"code": 0,
"request_id": "NTk5YmRjNjZfNmNhZDM1MGFfOGE0MF9lZDA1MQ == "
}