该操作将会开启分片上传并返回上传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))
无请求参数
名称 | 描述 | 需要 |
---|---|---|
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
名称 | 描述 |
---|---|
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>