- Print
- PDF
InitiateMultipartUpload
- Print
- PDF
Available in Classic and VPC
You can get an upload ID to reference when executing a multipart upload, where you upload an object in parts. The returned ID is an identifier that allows you to tie the uploaded parts together.
You must receive an upload ID before you can perform a multipart upload.
Requests
The following describes the request format for the endpoint. The request format is as follows.
Method | URI |
---|---|
POST | /{bucket-name}/{object-name} |
Request syntax
The request syntax is as follows.
POST https://{endpoint}/{bucket-name}/{object-name}?uploads= # path style
POST https://{bucket-name}.{endpoint}/{object-name}?uploads= # virtual host style
Request headers
For headers common to all Object Storage APIs, see Object Storage common headers.
Request path parameters
The following describes the parameters.
Field | Type | Required | Description |
---|---|---|---|
bucket-name | String | Required | Name of the bucket where the object is stored |
object-name | String | Required | Name of the object to run the multipart upload on |
Request query parameters
The following describes the parameters.
Field | Type | Required | Description |
---|---|---|---|
uploads | String | Required | Declare to include the upload ID in the response
|
Request example
The following is a sample request.
POST /some-bucket/multipart-object-123?uploads= HTTP/1.1
Authorization: {authorization-string}
x-amz-date: 20170303T203411Z
Host: kr.object.ncloudstorage.com
Responses
The following describes the response format.
Response headers
For response headers common to all Object Storage APIs, see Object Storage common response headers.
Response status codes
For response status codes common to all Object Storage APIs, see Object Storage response status codes.
Response example
The following is a sample response.
HTTP/1.1 200 OK
Date: Fri, 03 Mar 2017 20:34:12 GMT
Accept-Ranges: bytes
Content-Type: application/xml
Content-Length: 276
<InitiateMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Bucket>some-bucket</Bucket>
<Key>multipart-object-123</Key>
<UploadId>0000015a-95e1-4326-654e-a1b57887784f</UploadId>
</InitiateMultipartUploadResult>