CopyObject
- Print
- PDF
CopyObject
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
Available in Classic and VPC
Duplicate and upload an object from another location.
Requests
The following describes the request format for the endpoint. The request format is as follows.
| Method | URI |
|---|---|
| COPY | /v1/AUTH_{project_id}/{container}/{object} |
Request headers
The following describes the headers.
| Field | Type | Required | Description |
|---|---|---|---|
X-Auth-Token | String | Optional | Value of the issued token |
Destination | String | Required | Path to save the copy
|
X-Object-Meta-{name} | String | Optional | Metadata to set
|
X-Fresh-Metadata | Boolean | Optional | Whether to copy metadata
|
Content-Disposition | String | Optional | Browser's response handling method |
Content-Encoding | String | Optional | Object's encoding method |
Content-Type | String | Optional | Object's MIME type |
Request path parameters
The following describes the parameters.
| Field | Type | Required | Description |
|---|---|---|---|
project_id | String | Required | Project ID
|
container | String | Required | Name of the container where the target object will be stored |
object | String | Required | Name of the target object to copy |
Request query parameters
The following describes the parameters.
| Field | Type | Required | Description |
|---|---|---|---|
multipart-manifest | String | Conditional | Declare a multipart upload of a large object
|
Request example
The following is a sample request.
curl -L -X COPY 'https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}' \
-H 'X-Auth-Token: {token}' \
-H 'X-Object-Meta-collection: C5' \
-H 'Destination: {container}/{object name}' \
-H 'X-Fresh-Metadata: true'
Responses
The following describes the response format.
Response headers
The following describes the headers.
| Field | Type | Required | Description |
|---|---|---|---|
Content-Type | String | - | MIME type of the response result |
Content-Length | String | - | Length of the response result (bytes) |
ETag | String | - | ETag header value |
Last-Modified | String | - | Most recent modification time of the object (UTC) |
X-Copied-From-Account | String | - | Account of the source object (project ID) |
X-Copied-From | String | - | Path of the source object
|
X-Copied-From-Last-Modified | String | - | Last-Modified header value of the source object |
X-Object-Meta-{name} | String | - | Object metadata
|
X-Trans-Id | String | - | Transaction ID of the request |
X-Openstack-Request-Id | String | - | Transaction ID of the request
|
Date | String | - | Response time for the request (UTC) |
Response status codes
The following describes the response status codes.
| HTTP status code | Code | Message | Description |
|---|---|---|---|
| 201 | - | Created | Request succeeded |
Response example
The following is a sample response.
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
Was this article helpful?