租户端 存储 对象存储（COS） COS API参考 初始化分块上传

初始化分块上传

最近更新时间: 2024-10-17 17:10:00

功能描述

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

请求

请求示例

POST /<ObjectKey>?uploads HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
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 否

权限相关头部

说明：

了解更多 ACL 请求请参阅 ACL 概述文档。

名称 描述 类型 必选
x-cos-acl 定义 Object 的 ACL 属性，有效值：private，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-full-control 赋予被授权者所有的权限，格式：x-cos-grant-full-control: id="[OwnerUin]" String 否

请求体

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

响应

响应头

公共响应头

该响应使用公共响应头，了解公共响应头详情请参阅 公共响应头部 文档。

响应体

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

<InitiateMultipartUploadResult>
    <Bucket>examplebucket-1250000000</Bucket>
    <Key>exampleobject</Key>
    <UploadId>1484727270323ddb949d528c629235314a9ead80f0ba5d993a3d76b460e6a9cceb9633b08e</UploadId>
</InitiateMultipartUploadResult>

具体的数据内容如下：

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

Container 节点 InitiateMultipartUploadResult 的内容：

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

实际案例

请求

POST /exampleobject?uploads HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
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>examplebucket-1250000000</Bucket>
    <Key>exampleobject</Key>
    <UploadId>1484727270323ddb949d528c629235314a9ead80f0ba5d993a3d76b460e6a9cceb9633b08e</UploadId>
</InitiateMultipartUploadResult>