CopyObject
    • PDF

    CopyObject

    • PDF

    Article Summary

    Overview

    Copies objects from a different place.

    Syntax

    COPY /v1/AUTH_{project_id}/{container}/{object}
    

    Request

    NameInTypeDescription
    project_idpathstringProject ID
    containerpathstringContainer (bucket) name
    objectpathstringObject name
    multipart-manifest (Optional)querystringIf multipart-manifest=get, the object is considered a large object (SLO). The manifest of the object is copied, instead of its contents.
    X-Auth-Token (Optional)headerstringToken
    Content-Type (Optional)headerstringMIME type of the object
    Content-Encoding (Optional)headerstringEncoding type of the object
    Content-Disposition (Optional)headerstringRedefines browser behaviors.
    X-Object-Meta-{name} (Optional)headerstringMetadata of the object. The “name” part in the header name functions as a key of the metadata. You can add, update and delete metadata; leave this header empty to delete metadata.
    X-Fresh-Metadata (Optional)headerbooleanIf it is true, the API request only copies the object, without metadata. The default value is false.

    Response

    NameInTypeDescription
    Content-LengthheaderstringLength of the response result (in bytes)
    X-Copied-From-Last-Modified (Optional)headerintegerlast_modified header value of the source object
    X-Copied-From (Optional)headerstringPath of the source object
    X-Copied-From-Account (Optional)headerstringAccount of the source object
    Last-ModifiedheaderstringThe latest time when the copied object was updated (in UTC)
    ETagheaderstringETag header value
    X-Trans-IdheaderstringTransaction ID of the request
    X-Openstack-Request-IdheaderstringTransaction ID of the request (same as X-Trans-Id)
    DateheaderstringResponse time of the request (in UTC)
    Content-TypeheaderstringMIME type of the response result

    Examples

    Request example

    curl -i -X COPY -H "X-Auth-Token: $token" -H "Destination: $copy_destination" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}
    

    Response example

    HTTP/1.1 201 Created
    Last-Modified: Mon, 17 Sep 2018 08:21:36 GMT
    Content-Length: 0
    Etag: f1c9645dbc14efddc7d8a322685f26eb
    Content-Type: text/html; charset=UTF-8
    X-Copied-From-Account: AUTH_{project_id}
    X-Copied-From-Last-Modified: Mon, 17 Sep 2018 07:43:40 GMT
    X-Copied-From: ncloud-container-0/ncloud-object-0
    X-Trans-Id: tx851b895d7fcf47f987a5a-005b9f640f
    X-Openstack-Request-Id: tx851b895d7fcf47f987a5a-005b9f640f
    Date: Mon, 17 Sep 2018 08:21:35 GMT
    

    The API request copies the object.
    It returns Created (201) status code if successful.


    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.