文档平台 API 中心 对象存储 Object接口 Initiate Multipart Upload

Initiate Multipart Upload

最近更新时间:2018-11-13 11:27:56

功能描述

Initiate Multipart Upload 接口请求实现初始化分片上传,成功执行此请求以后会返回 UploadId 用于后续的 Upload Part 请求。

请求

请求示例

POST /Object?uploads HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String

Authorization: Auth String (详细参见 请求签名 章节)

请求头

公共头部

该请求操作的实现使用公共请求头,了解公共请求头详情,请参阅 公共请求头部 章节。

非公共头部

推荐头部
该请求操作的实现使用如下推荐请求头部信息:

名称 描述 类型 必选
Cache-Control RFC 2616 中定义的缓存策略,将作为 Object 元数据保存。 String
Content-Disposition RFC 2616 中定义的文件名称,将作为 Object 元数据保存。 String
Content-Encoding RFC 2616 中定义的编码格式,将作为 Object 元数据保存。 String
Content-Type RFC 2616 中定义的内容类型(MIME),将作为 Object 元数据保存。 String
Expires RFC 2616 中定义的文件日期和时间,将作为 Object 元数据保存。 String
x-cos-meta-* 包括用户自定义头部后缀和用户自定义头部信息,将作为 Object 元数据返回,大小限制为 2KB。
注意:用户自定义头部信息支持下划线,但用户自定义头部后缀不支持下划线。
String
x-cos-storage-class 设置 Object 的存储级别,枚举值:STANDARD, STANDARD_IA,默认值:STANDARD String

权限相关头部
该请求操作的实现可以用 PUT 请求中的 x-cos-acl 头来设置 Object 访问权限。目前 Object 有三种访问权限:public-read-write,public-read 和 private。如果不设置,默认为 private 权限。也可以单独明确赋予用户读、写或读写权限。内容如下:

了解更多 acl 请求可详细请参见 Put Bucket acl 文档。

名称 描述 类型 必选
x-cos-acl 定义 Object 的 ACL 属性,有效值:private,public-read-write,public-read,default;默认值:default(继承 Bucket 权限);注:当前访问策略条目限制为 1000 条,如果您不需要进行 Object ACL 控制,请填 default 或者此项不进行设置,默认继承 Bucket 权限。 String
x-cos-grant-read 赋予被授权者读的权限。格式:x-cos-grant-read: id="[OwnerUin]" String
x-cos-grant-write 赋予被授权者写的权限。格式:x-cos-grant-write: id="[OwnerUin]" String
x-cos-grant-full-control 赋予被授权者所有的权限。格式:x-cos-grant-full-control: id="[OwnerUin]" String

服务端加密相关头部

该请求操作指定腾讯云 COS 在数据存储时,应用数据加密的保护策略。腾讯云 COS 会帮助您在数据写入数据中心时自动加密,并在您取用该数据时自动解密。目前支持使用腾讯云 COS 主密钥对数据进行 AES-256 加密。如果您需要对数据启用服务端加密,则需传入以下头部:

名称 描述 类型 必选
x-cos-server-side-encryption 指定将对象启用服务端加密的方式。
使用 COS 主密钥加密填写:AES256
String 如需加密,是

请求体

该请求的操作请求体为空。

响应

响应头

公共响应头

该响应使用公共响应头,了解公共响应头详细请参见 公共响应头部 章节。

特有响应头

服务端加密相关响应

如果在上传时指定使用了服务端加密,响应头部将会包含如下信息:

名称 描述 类型
x-cos-server-side-encryption 如果通过 COS 管理的服务器端加密来存储对象,响应将包含此头部和所使用的加密算法的值,AES256。 String

响应体

该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:

<InitiateMultipartUploadResult>
  <Bucket></Bucket>
  <Key></Key>
  <UploadId></UploadId>
</InitiateMultipartUploadResult>

具体的数据内容如下:

节点名称(关键字) 父节点 描述 类型
InitiateMultipartUploadResult 说明所有返回信息 Container

Container 节点 InitiateMultipartUploadResult 的内容:

节点名称(关键字) 父节点 描述 类型
Bucket InitiateMultipartUploadResult 分片上传的目标 Bucket,由用户自定义字符串和系统生成appid数字串由中划线连接而成,如:mybucket-1250000000 Container
Key InitiateMultipartUploadResult Object 的名称 Container
UploadId InitiateMultipartUploadResult 在后续上传中使用的 ID Container

实际案例

请求

POST /ObjectName?uploads HTTP/1.1
Host: arlenhuangtestsgnoversion-1251668577.cos.ap-beijing.myqcloud.com
Date: Fri, 10 Mar 2016 09:45:46 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDWtTCBYjM5OwLB9CAwA1Qb2ThTSUjfGFO&q-sign-time=1484727259;32557623259&q-key-time=1484727259;32557623259&q-header-list=host&q-url-param-list=uploads&q-signature=b5f46c47379aeaee74be7578380b193c01b28045

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 230
Connection: keep-alive
Date: Fri, 10 Mar 2016 09:45:46 GMT
Server: tencent-cos
x-cos-request-id: NTg3ZjIzZTZfOWIxZjRlXzZmMzhfMWRj

<InitiateMultipartUploadResult>
    <Bucket>arlenhuangtestsgnoversion-1251668577</Bucket>
    <Key>ObjectName</Key>
    <UploadId>1484727270323ddb949d528c629235314a9ead80f0ba5d993a3d76b460e6a9cceb9633b08e</UploadId>
</InitiateMultipartUploadResult>