InitiateMultipartUpload
    • PDF

    InitiateMultipartUpload

    • PDF

    Article summary

    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.

    MethodURI
    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.

    FieldTypeRequiredDescription
    bucket-nameStringRequiredName of the bucket where the object is stored
    object-nameStringRequiredName of the object to run the multipart upload on

    Request query parameters

    The following describes the parameters.

    FieldTypeRequiredDescription
    uploadsStringRequiredDeclare to include the upload ID in the response
    • Enter only keys without values

    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>
    
    

    Was this article helpful?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.