InitiateMultipartUpload
更新时间 2026-04-10 20:11:05
最近更新时间: 2026-04-10 20:11:05
功能说明
InitiateMultipartUpload分段上传初始化请求实现初始化分片上传,成功执行此请求以后会返回Upload ID用于后续的分段上传请求。
请求消息样式
POST /{Bucket}/{Key}?uploads HTTP/1.1
Host: xxx.zos.ctyun.cn
x-amz-acl: private
x-amz-storage-class: STANDARD
x-amz-tagging: tag-key=tag-value
x-amz-content-SHA256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b85
x-amz-Date: 20220406T063538Z
Authorization: string请求消息参数
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释: Bucket的名称。 | String | 是 |
| Key | 参数解释: 对象的Key。 | String | 是 |
请求消息头
该请求使用公共的请求消息头,请参见如何调用API-构造请求-请求消息头。但可以带附加消息头,附加请求消息头如下表所示。
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| x-amz-acl | 参数解释: 设置要上传对象的ACL规则,参见Put Object ACL。 | String | 否 |
| x-amz-storage-class | 参数解释: 设置目的对象存储级别 取值范围: - STANDARD:标准存储 - STANDARD_IA:低频存储 - GLACIER:归档存储 默认取值: STANDARD | String | 否 |
| x-amz-tagging | 参数解释: 设置目的对象TAG,参见Put Object Tagging。 | String | 否 |
请求消息元素
该请求消息中不带消息元素。
响应消息样式
HTTP/1.1 Status Code
x-amz-request-id: tx00000000000000000001d-00624d34ba-5403f-default
Content-Type: application/xml
Content-Length: 240
Date: Wed, 06 Apr 2022 06:35:38 GMT
Connection: Keep-Alive
<?xml version="1.0" encoding="UTF-8"?>
<InitiateMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Bucket>bk-multi-part</Bucket>
<Key>obj</Key>
<UploadId>2~VH_fTnlYabDYVAOgyL07QqKrratNl2w</UploadId>
</InitiateMultipartUploadResult>响应消息头
该请求的响应消息使用公共的响应消息头,请参见如何调用API-响应结果-响应消息头。
响应消息元素
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| InitiateMultipartUploadResult | 参数解释: 初始化分段上传的请求结果。 | Container |
表 InitiateMultipartUploadResult
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| Bucket | 参数解释: 对象待上传的Bucket名称。 | String |
| Key | 参数解释: 待上传的对象名称。 | String |
| UploadId | 参数解释: 本次分段上传的upload ID。 | String |
错误码
请参见调用前必知-错误码-全局错误码。