对象存储经典版I型 > 天翼云对象存储（经典版）I型API参考-Initial Multipart Upload

天翼云对象存储（经典版）I型API参考-Initial Multipart Upload

产品推荐：

1、安全稳定的云服务器租用，2核/2G/5M仅37元，点击抢购>>>；

2、高防物理服务器20核/16G/50M/500G防御仅350元，点击抢购>>>

3、百度智能建站（五合一网站）仅880元/年，点击抢购>>> 模板建站（PC+手机站）仅480元/年，点击抢购>>>

4、阿里云服务器2核2G3M仅99元/年、2核4G5M仅199元/年，新老同享，点击抢购>>>

5、腾讯云服务器2核2G4M仅99元/年、新老同享，点击抢购>>>

点击这里注册天翼云特邀VIP帐号，立即体验天翼云对象存储>>>

天翼云对象存储（经典版）I型API参考-Initial Multipart Upload

本接口初始化一个分片上传（Multipart Upload）操作，并返回一个上传ID。此ID用来将此次分片上传操作中上传的所有片段合并成一个对象。用户在执行每一次子上传请求（见Upload Part）时都必须指定该ID。用户也可以在表示整个分片上传完成的合并分片的请求中指定该ID。或者在用户放弃该分片上传操作时指定该ID。

请求语法

POST /ObjectName?uploads HTTP/1.1

Host: bucketName.oos-cn.ctyunapi.cn

Date: date

Authorization: signatureValue

请求头

名称	描述	是否必须
Cache-Control	可以用来指定请求或响应中的缓存操作。类型：字符串。	否
Content-Disposition	指定对象的描述性信息。类型：字符串。	否
Content-Encoding	指定对象的描述性信息采用何种编码方式以及在获取被Content-Type头字段引用的media-type时采用何种解码方式。类型：字符串。	否
Content-Type	用来描述对象数据格式的标准MIME类型。类型：字符串。取值：MIME类型，默认值为application/octet-stream。	否
Expires	对象不再被缓存的时间。类型：字符串。	否
x-amz-meta-	任何以x-amz-meta-为前缀的头都被当作用户元数据，它和对象一起存储，当用户获取该对象的时候作为响应的一部分被返回。类型：字符串。	否
x-amz-storage-class	对象的存储类型，针对那些在成功完成分片上传后被创建的对象。类型：字符串。取值： l STANDARD：标准存储 l STANDARD_IA：低频访问存储默认值为STANDARD	否
x-ctyun-data-location	设置Bucket的数据位置。注意：香港节点不支持此参数。类型：key-value形式。有效值：格式为：type=Local,scheduleStrategy=scheduleStrategy或者type=Specified,location=location,scheduleStrategy=scheduleStrategy l type：指定数据存储位置的类型，取值为Local或者Specified。local表示就近写入，Specified表示指定位置。如果type取值为Specified，则需要指定具体的数据位置location，location可以填写多个，以逗号分隔，可取值为ChengDu、GuiYang、LaSa、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou。 l scheduleStrategy：调度策略，取值为： Ø Allowed：允许OOS自动调度数据存储位置 Ø NotAllowed：不允许OOS自动调度数据存储位置。	否

响应结果

名称	描述
InitiateMultipartUploadResult	包含所有返回元素的容器。类型：容器子节点：Bucket，Key，UploadId
Bucket	分片上传对应的Bucket的名称。类型：Sring 父节点：InitiateMultipartUploadResult
Key	分片上传对应的对象名称。类型：字符串父节点：InitiateMultipartUploadResult
UploadId	分片上传ID。类型：字符串父节点：InitiateMultipartUploadResult

请求示例

初始化一个名为“example-object”对象的分片上传操作。

POST /example-object?uploads HTTP/1.1
Host: example-bucket.oos-cn.ctyunapi.cn
Date: Mon, 1 Nov 2010 20:34:56 GMT
Authorization: AWS 7799e793ce4624ee7e5a:xQE0diMbLRepdf3YB+FIEXAMPLE=

响应示例

HTTP/1.1 200 OK
x-amz-request-id: 656c76696e6727732072657175657374
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 197
Server: CTYUN
 
<?xml version="1.0" encoding="UTF-8"?>
<InitiateMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Bucket>example-bucket</Bucket>
  <Key>example-object</Key>
  <UploadId>1638428231343309398</UploadId>
</InitiateMultipartUploadResult>

天翼云文档

百度智能云文档

腾讯云文档

阿里云文档

华为云文档

帐号服务

云计算

云安全

企业服务

备案服务

请求语法

请求头

响应结果

请求示例

响应示例

TOP云产品

解决方案

帮助与支持

其他链接

快速通道

关于 TOP云