--- title: "CopyObject" slug: "ncloudstorage-copyobject" updated: 2026-10-08T07:18:12Z published: 2026-10-08T07:18:12Z canonical: "api.ncloud-docs.com/ncloudstorage-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. # CopyObject Classic/VPC環境で利用できます。 Ncloud Storageバケットに保存されているオブジェクトをコピーして保存します。最大5GBのオブジェクトまでコピーできます。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | PUT | /{Key} | ### リクエストヘッダ リクエストヘッダの説明は次の通りです。 参考 Ncloud Storage APIで共通して使用されるヘッダの詳細は、[Ncloud Storageのリクエストヘッダ](/docs/ja/storage-ncloudstorage#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 | フィールド | 必須の有無 | 説明 | | --- | --- | --- | | `x-amz-copy-source` | Required | コピー対象のオブジェクト - {バケット名}/{オブジェクト名}形式で入力 - バケット名: [ListBuckets](/docs/ja/ncloudstorage-listbuckets)を参照 - オブジェクト名: [ListObjectsV2](/docs/ja/ncloudstorage-listobjectsv2)を参照 - 例) `bucket000/object000.csv` - バージョン管理が設定されたバケットでオブジェクトの特定のバージョンをコピーする場合、入力値に`?versionId={versionId}`を追加 - バージョン IDの確認: [ListObjectVersions](/docs/ja/ncloudstorage-listobjectversions)を参照 | | `Cache-Control` | Optional | キャッシュ動作 | | `Content-Disposition` | Optional | リクエストデータの表示方法 | | `Content-Encoding` | Optional | リクエストデータのエンコード方法 | | `Content-Language` | Optional | リクエストデータの言語 | | `Content-Type` | Optional | リクエストデータの形式 | | `x-amz-metadata-directive` | Optional | メタデータの処理方法 - `COPY` (デフォルト) \| `REPLACE` - `COPY`: コピー元をコピー - `REPLACE`: 再定義 | | `x-amz-storage-class` | Optional | ストレージクラス - `STANDARD` (デフォルト) \| `ONEZONE_IA` \| `DEEP_ARCHIVE` - `STANDARD`: Standard Class - `ONEZONE_IA`: One Zone-IA(Infrequent Access) Class - `DEEP_ARCHIVE`: Archive Class | | `x-amz-server-side-encryption` | Optional | サーバ側の暗号化方式 - `AES256`: SSE-S3 (サーバ管理キー) - `aws:kms`: SSE-KMS (KMS管理キー) | | `x-amz-server-side-encryption-customer-algorithm` | Optional | ユーザー暗号化アルゴリズム (AES256) | | `x-amz-server-side-encryption-customer-key` | Optional | ユーザー提供の暗号化キー | | `x-amz-server-side-encryption-customer-key-MD5` | Optional | ユーザー提供暗号化キーの MD5 | | `x-amz-copy-source-server-side-encryption-customer-algorithm` | Optional | コピー元のユーザー暗号化アルゴリズム (AES256) | | `x-amz-copy-source-server-side-encryption-customer-key` | Optional | コピー元のユーザー提供の暗号化キー | | `x-amz-copy-source-server-side-encryption-customer-key-MD5` | Optional | コピー元のユーザー提供暗号化キーの MD5 | | `x-amz-object-lock-mode` | Optional | オブジェクトのリテンションモード - `GOVERNANCE` \| `COMPLIANCE` - `GOVERNANCE`: 特別な権限でバイパス可能 - `COMPLIANCE`: いかなるユーザーもバイパス不可 - `x-amz-object-lock-retain-until-date`と併せて指定 - Object Lockが有効になっているバケットでのみ使用可能 | | `x-amz-object-lock-retain-until-date` | Optional | オブジェクトのリテンション期限 - ISO 8601形式 - `x-amz-object-lock-mode`と併せて指定 - Object Lockが有効になっているバケットでのみ使用可能 | | `x-amz-object-lock-legal-hold` | Optional | リーガルホールドの状態 - `ON` \| `OFF` - Object Lockが有効になっているバケットでのみ使用可能 | ### リクエストパスパラメータ リクエストパスパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `Key` | String | Required | オブジェクトコピーの名前 - バケット内フォルダに保存する場合、`{フォルダ名}/{ファイル名}`形式で入力 | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` PUT /object.jpg HTTP/1.1 Host: bucket.kr.ncloudstorage.com x-amz-copy-source: bucket000/object.csv Cache-Control: no-cache Content-Disposition: attachment; filename=object.csv Content-Language: en x-amz-metadata-directive: REPLACE ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスヘッダ Ncloud Storage APIで共通して使用されるヘッダの詳細は、[Ncloud Storageのレスポンスヘッダ](/docs/ja/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94)をご参照ください。 ### レスポンスボディ レスポンスボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `CopyObjectResult` | Object | - | オブジェクトコピーの結果 | | `CopyObjectResult.LastModified` | String | - | 最終更新日時 - ISO 8601形式 | | `CopyObjectResult.ETag` | String | - | オブジェクトの固有 ID(Entity Tag) | ### レスポンスステータスコード Ncloud Storage APIで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud Storageのレスポンスステータスコード](/docs/ja/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 ``` HTTP/1.1 200 OK 2025-04-28T09:36:57Z "2dd********************4f6181" ```