The operation will enable multipart upload and return Upload ID. The Upload ID is used to associate with all multiparts uploaded by specific segments. You can specify the Upload ID in the request for each time you execute the subsequent multipart upload; you can also specify the Upload ID in the last request to complete multipart upload.
POST /ObjectName?uploads HTTP/1.1 Host: <bucket>.s3.<region>.jdcloud-oss.com Date: <date> Authorization: <authorization string> (see Authenticating Requests (AWS Signature Version4))
No Request Parameters
| Name | Description | Need |
|---|---|---|
| Cache-Control | Specify cache behavior in the whole request/response chain. Type: String Default: None |
No |
| Content-Disposition | Specify which form will the returned Object be displayed; See RFC2616 for detailed description. Type: String Default: None Constraints: None |
No |
| Content-Encoding | Its value presents what kind of content encoding conversion that the message body carried out, which is used to inform the client how to decode for obtaining media type content indicated in Content-Type; see RFC2616 for detailed description. Type: String Default: None Constraints: None |
No |
| Content-Length | The size unit of Object is byte; see RFC2616 for detailed description. Type: String Default: None Constraints: None |
Yes |
| Content-MD5 | Obtain 128-bit binary number from packet body with MD5 algorithm, then write it into Centen-MD5 through Base64 coding, which is applied to check data integrity. Type: String Default: None Constraints: None |
No |
| Content-Type | Present MIME type in the request. Type: String Default: binary/octet-stream Valid Values: MIME types Constraints: None |
No |
| Expect | The client uses Expect to inform OSS, expecting to occur certain specific behavior. If errors occur because OSS cannot respond, request packet body will not be sent. Type: String Default: None Valid Values: 100-continue Constraints: None |
No |
| Expires | Object Cache Expiration Time. Type: String Default: None Constraints: None |
No |
| x-amz-storage-class | Object Storage Type, if it is not specified, it will be standard storage by default. Type: Enum Default: STANDARD Valid Values: STANDARD, GLACIER, REDUCED_REDUNDANCY |
No |
No Request Elements
No Special Header
| Name | Description |
|---|---|
| InitiateMultipartUploadResult | Response Set. Type: Container Children: Bucket, Key, UploadId Ancestors: None |
| Bucket | Name of Bucket where multipart upload is executed Type: String Ancestors: InitiateMultipartUploadResult |
| Key | Objects executing multipart upload. Type: String Ancestors: InitiateMultipartUploadResult |
| UploadID | ID of multipart upload. 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>