PutObject (Copy)
- Print
- PDF
PutObject (Copy)
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
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.
| Method | URI |
|---|---|
| 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
Request headers
The following describes the PutObject (Copy) header. For headers common to all Object Storage APIs, see Object Storage common request headers.
| Field | Type | Required | Description |
|---|---|---|---|
| x-amz-metadata-directive | String | Optional | Set up to change original metadata
|
| x-amz-copy-source-if-match | String | Optional | Create a copy if the specified ETag string matches the source object |
| x-amz-copy-source-if-none-match | String | Optional | Create a copy if the specified ETag string is different from the source object |
| x-amz-copy-source-if-unmodified-since | String | Optional | Create a copy if the source object hasn't been edited since the specified date
|
| x-amz-copy-source-if-modified-since | String | Optional | Create a copy if the source object has been edited since the specified date
|
Request path parameters
The following describes the parameters.
| Field | Type | Required | Description |
|---|---|---|---|
bucket-name | String | Required | Name of the bucket to create a copy of the object in |
object-name | String | Required | Name 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
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
<CopyObjectResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<LastModified>2016-11-30T19:52:53.125Z</LastModified>
<ETag>"853aab195ce770b0dfb294a4e9467e62"</ETag>
</CopyObjectResult>
Was this article helpful?