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

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

喜讯：国内、香港、海外云服务器租用特惠活动，2核/4G/10M仅需31元每月，点击抢购>>>

天翼云对象存储（经典版）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云