MENU
      PutObject (Copy)

        PutObject (Copy)


        Article summary

        Available in Classic and VPC

        Create a copy of the object based on the specified headers. No request query parameter or request body is used in the operation.

        Note
        • Unless you make changes to the copy, the metadata in the copy remains the same as the original. However, the ACL settings applied to the account that the copy is created on are reset to private.

        Requests

        The following describes the request format for the endpoint. The request format is as follows.

        MethodURI
        PUT/{bucket-name}/{object-name}

        Request syntax

        The request syntax is as follows.

        PUT https://{endpoint}/{bucket-name}/{object-name} # path style
        PUT https://{bucket-name}.{endpoint}/{object-name} # virtual host style
        HTTP

        Request headers

        The following describes the PutObject (Copy) header. For headers common to all Object Storage APIs, see Object Storage common request headers.

        FieldTypeRequiredDescription
        x-amz-metadata-directiveStringOptionalSet up to change original metadata
        • COPY | REPLACE
          • Overwrite the original metadata with the new metadata provided when entering REPLACE
        x-amz-copy-source-if-matchStringOptionalCreate a copy if the specified ETag string matches the source object
        x-amz-copy-source-if-none-matchStringOptionalCreate a copy if the specified ETag string is different from the source object
        x-amz-copy-source-if-unmodified-sinceStringOptionalCreate a copy if the source object hasn't been edited since the specified date
        • Must be in a valid date format
          • <Example> Wed, 30 Nov 2016 20:21:38 GMT
        x-amz-copy-source-if-modified-sinceStringOptionalCreate a copy if the source object has been edited since the specified date
        • Must be in a valid date format
          • <Example> Wed, 30 Nov 2016 20:21:38 GMT

        Request path parameters

        The following describes the parameters.

        FieldTypeRequiredDescription
        bucket-nameStringRequiredName of the bucket to create a copy of the object in
        object-nameStringRequiredName of the object to copy

        Request example

        The following is a sample request.

        PUT /example-bucket/wild-bee HTTP/1.1
        Authorization: {authorization-string}
        x-amz-date: 20161130T195251Z
        x-amz-copy-source: /garden/bee
        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: Wed, 30 Nov 2016 19:52:52 GMT
        Accept-Ranges: bytes
        x-amz-request-id: 72992a90-8f86-433f-b1a4-7b1b33714bed
        ETag: "853aab195ce770b0dfb294a4e9467e62"
        Content-Type: application/xml
        Content-Length: 240
        HTTP
        <CopyObjectResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
          <LastModified>2016-11-30T19:52:53.125Z</LastModified>
          <ETag>"853aab195ce770b0dfb294a4e9467e62"</ETag>
        </CopyObjectResult>
        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.