初始化分片上传

最近更新时间:2023-10-08 09:17:34

接口描述

  • 接口名称:InitiateMultipartUpload
  • 接口功能:该接口请求用于实现初始化分片上传,成功执行此请求后将返回 UploadId,用于后续的 UploadPart 请求。如果已存在同名的对象,则接口会返回对象已存在的错误。创建成功后,除非取消上传,否则将无法上传或分片上传同名的对象。

请求

请求示例

POST /<CofferName-APPID>/<ObjectKey>?uploads HTTP/1.1
Host: cdcs.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String

说明:

Authorization: Auth String 详情,请参见 请求签名 文档。

请求头

公共头部

该请求操作的实现使用公共请求头部,了解公共请求头详情,请参见 公共请求头部 文档。

非公共头部

推荐头部

名称 必选 类型 描述
Content-Type String RFC 2616 中定义的内容类型(MIME),将作为 Object 元数据保存。

请求体

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

响应

响应头

公共响应头

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

特有响应头

响应体

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

{
    "Coffer": "examplecoffer-1250000000",
    "Key": "exampleobject",
    "UploadId": "1484727270323ddb949d528c629235314a9ead80f0ba5d993a3d76b460e6a9cceb9633b08e"
}

具体的数据内容如下

节点名称(关键字) 类型 描述
Coffer string 分片上传的目标 Coffer,由用户自定义字符串和系统生成 AppID 数字串组成,例如 examplecoffer-1250000000。
Key string Object 的名称。
UploadId string 在后续上传中使用的 ID。

错误码

此接口的特殊错误信息如下所述,全部错误信息请参见 错误码 文档。

错误码 HTTP 状态码 描述
ObjectAlreadyExists 409 Conflict 指定的对象已存在(也可能是正在上传中或分片上传中)。
ObjectAlreadyExistsOwnedByYou 409 Conflict 指定的对象已存在且由当前账户创建(也可能是正在上传中或分片上传中)。
AssumeRoleFailed 409 Conflict 扮演角色失败,检查是否已授予保险箱角色。
KMSFailed 409 Conflict 调用 KMS 失败。

示例

请求

POST /examplecoffer-1250000000/exampleobject?uploads HTTP/1.1
Host: cdcs.ap-beijing.myqcloud.com
Date: Fri, 10 Mar 2016 09:45:46 GMT
Authorization: [Auth String]

响应

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-cdcs
x-cdcs-request-id: NTg3ZjIzZTZfOWIxZjRlXzZmMzhfMWRj

{
    "Coffer": "examplecoffer-1250000000",
    "Key": "exampleobject",
    "UploadId": "1484727270323ddb949d528c629235314a9ead80f0ba5d993a3d76b460e6a9cceb9633b08e"
}