接口描述
- 接口名称：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"
}