MENU
      InitiateMultipartUpload

        InitiateMultipartUpload


        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
        HTTP

        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
        HTTP

        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
        HTTP
        <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>
        XML

        Was this article helpful?

        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.