喜讯：国内、香港、海外云服务器租用特惠活动，2核/4G/10M仅需31元每月，点击抢购>>>
点击这里注册天翼云特邀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云智能建站优惠活动，仅880元即可搭建一个后台管理五端合一的智能网站（PC网站、手机网站、百度智能小程序、微信小程序、支付宝小程序），独享百度搜索SEO优势资源，让你的网站不仅有颜值有排面，更有排名，可以实实在在为您带来效益，请点击进入TOP云智能建站>>>，或咨询在线客服了解详情。
湘公网安备43019002001857号
备案号：
客服1 