--- title: "PutObject (Copy)" slug: "storage-objectstorage-copyobject" updated: 2026-09-17T09:58:30Z published: 2026-09-17T09:58:30Z canonical: "api.ncloud-docs.com/storage-objectstorage-copyobject" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # PutObject (Copy) Classic/VPC環境で利用できます。 指定したヘッダを利用してオブジェクトのコピーを作成します。オペレーションに使用されるリクエストクエリパラメータ、リクエストボディはありません。 参考 - コピーを変更しない限り、コピーのメタデータはソースと同じままです。ただし、コピーを作成したアカウントに適用された ACL設定は、privateに再設定されます。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | PUT | /{bucket-name}/{object-name} | ### リクエスト構文 リクエスト構文は次の通りです。 ``` PUT https://{endpoint}/{bucket-name}/{object-name} # path style PUT https://{bucket-name}.{endpoint}/{object-name} # virtual host style ``` ### リクエストヘッダ PutObject (Copy)ヘッダを紹介します。Object Storage APIリクエストで共通して使用されるヘッダの詳細は、[Object Storage共通リクエストヘッダ](/docs/ja/storage-objectstorage#%EA%B3%B5%ED%86%B5%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | x-amz-metadata-directive | String | Optional | ソースメタデータの変更を設定 - `COPY` \| `REPLACE` - `REPLACE`入力時に提供される新しいメタデータでソースメタデータを上書きする | | x-amz-copy-source-if-match | String | Optional | 指定した ETag文字列がソースオブジェクトと一致する場合、コピーを作成 | | x-amz-copy-source-if-none-match | String | Optional | 指定した ETag文字列がソースオブジェクトと異なる場合、コピーを作成 | | x-amz-copy-source-if-unmodified-since | String | Optional | 指定した日付以降にソースオブジェクトを変更しなかった場合、コピーを作成 - 有効な日付形式であることが必要 - <例> Wed, 30 Nov 2016 20:21:38 GMT | | x-amz-copy-source-if-modified-since | String | Optional | 指定した日付以降にソースオブジェクトを変更した場合、コピーを作成 - 有効な日付形式であることが必要 - <例> Wed, 30 Nov 2016 20:21:38 GMT | ### リクエストパスパラメータ パラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `bucket-name` | String | Required | オブジェクトのコピーを作成するバケットの名前 | | `object-name` | String | Required | コピーするオブジェクトの名前 | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` 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 ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスヘッダ Object Storage APIで共通して使用されるレスポンスヘッダの詳細は、[Object Storageの共通レスポンスヘッダ](/docs/ja/storage-objectstorage#%EA%B3%B5%ED%86%B5%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94)をご参照ください。 ### レスポンスステータスコード Object Storage APIで共通して使用されるレスポンスステータスコードの詳細は、[Object Storageのレスポンスステータスコード](/docs/ja/storage-objectstorage#%EC%98%A4%EB%A5%98%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 ``` 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 ``` ``` 2016-11-30T19:52:53.125Z "853aab195ce770b0dfb294a4e9467e62" ```