对象存储

产品文档

对象存储

帮助中心 > 产品文档 > 对象存储 > Initiate Multipart Upload

Initiate Multipart Upload

描述

该操作将会开启分片上传并返回上传ID。该上传ID用于关联特定的分段上传的所有分片。您可以在后续每次执行分片上传请求中指定此上传ID;也可以在最后的请求中指定此上传ID完成分片上传。

请求

语法

POST /ObjectName?uploads HTTP/1.1
Host: <bucket>.s3.<region>.jdcloud-oss.com
Date: <date>
Authorization: <authorization string> (see Authenticating Requests (AWS Signature Version4))

请求参数

无请求参数

请求Header

名称 描述 需要
Cache-Control 在整个请求/响应链中指定缓存行为。
Type: String
Default: None
Content-Disposition 指定返回的Object该以何种形式展示;更详细描述请参照RFC2616。
Type: String
Default: None
Constraints: None
Content-Encoding 它的值表示消息主体进行了何种方式的内容编码转换,用来告知客户端应该怎样解码才能获取在 Content-Type 中标示的媒体类型内容;更详细描述请访问RFC2616。
Type: String
Default: None
Constraints: None
Content-Length Object的大小,单位为byte;更详细描述请参照RFC2616。
Type: String
Default: None
Constraints: None
Content-MD5 对报文主体进行MD5算法获得128位二进制数,在通过Base64编码写入Content-MD5。可用于数据完整性检查。
Type: String
Default: None
Constraints: None
Content-Type 表示请求中的MIME类型。
Type: String
Default: binary/octet-stream
Valid Values: MIME types
Constraints: None
Expect 客户端使用Expect告知OSS,期望出现某种特定的行为。若OSS无法做出回应而发生错误时,请求报文主体将不会发送。
Type: String
Default: None
Valid Values: 100-continue
Constraints: None
Expires Object缓存过期时间。
Type: String
Default: None
Constraints: None
x-amz-storage-class Object存储类型,如果未指定,默认为标准存储。
Type: Enum
Default: STANDARD
Valid Values: STANDARD、GLACIER、REDUCED_REDUNDANCY、STANDARD_IA
x-amz-tagging 设置对象标签。如"Key1=Value1"
Type: String
Default: None
Constraints:标签键和标签值需分别做urlencode。该标签头大小不能超过2K。标签个数不能超过10个。
x-amz-meta-* 以x-amz-meta- 前缀开头的Header为用户自定义Header。自定义Header的大小(包括key、value)UTF-8编码下不能超过2K。

请求元素

无请求元素

响应

响应Header

无特殊Header

响应元素

名称 描述
InitiateMultipartUploadResult 响应集合。
Type: Container
Children: Bucket, Key, UploadId
Ancestors: None
Bucket 执行分片上传所在的Bucket名称
Type: String
Ancestors: InitiateMultipartUploadResult
Key 执行分片上传的Object。
Type: String
Ancestors: InitiateMultipartUploadResult
UploadID 分片上传ID。
Type: String
Ancestors: InitiateMultipartUploadResul

示例

请求示例

POST /example-object?uploads HTTP/1.1
Host: oss-example.s3.<region>.jdcloud-oss.com
Date: Mon, 1 Nov 2010 20:34:56 GMT
Authorization: <authorization string>

响应示例
HTTP/1.1 200 OK
x-amz-request-id: 656c76696e6727732072657175657374
Date:  Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 197
Connection: keep-alive
Server: JDCloudOSS

<?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>VXBsb2FkIElEIGZvciA2aWWpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZA</UploadId>
</InitiateMultipartUploadResult>
更新时间:2020-12-16 12:09:54