--- title: "UploadPartCopy" slug: "ncloudstorage-uploadpartcopy" updated: 2026-10-08T07:18:10Z published: 2026-10-08T07:18:10Z canonical: "api.ncloud-docs.com/ncloudstorage-uploadpartcopy" --- > ## 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. # UploadPartCopy Classic/VPC環境で利用できます。 Ncloud Storageバケットに保存されているオブジェクトをコピーして、マルチパートアップロードのパートでアップロードします。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | 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 | コピー対象のオブジェクト - `{bucket name}/{object name}`形式で入力 - バケット名: [ListBuckets](/docs/ja/ncloudstorage-listbuckets)を参照 - オブジェクト名: [ListObjectsV2](/docs/ja/ncloudstorage-listobjectsv2)を参照 - 例) `bucket/object.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-copy-source-range` | Optional | コピー元からコピーするバイトの範囲 | | `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 | ### リクエストパスパラメータ リクエストパスパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `Key` | String | Required | オブジェクト名 - [CreateMultipartUpload](/docs/ja/ncloudstorage-createmultipartupload)を参照 | ### リクエストクエリパラメータ リクエストクエリパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `partNumber` | Integer | Required | パート番号 - 1~10,000 | | `uploadId` | String | Required | マルチパートアップロード ID - [CreateMultipartUpload](/docs/ja/ncloudstorage-createmultipartupload)を参照 | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` PUT /object.zip?partNumber=2&uploadId=2c5f5e8c-****-****-****-9cc2c468d0e9 HTTP/1.1 Host: bucket.kr.ncloudstorage.com x-amz-copy-source: bucket/part2.zip Cache-Control: no-cache Content-Language: en ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスヘッダ Ncloud Storage APIで共通して使用されるヘッダの詳細は、[Ncloud Storageのレスポンスヘッダ](/docs/ja/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94)をご参照ください。 ### レスポンスボディ レスポンスボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `CopyPartResult` | Object | - | オブジェクトのコピーのマルチパートアップロードの結果 | | `CopyPartResult.LastModified` | String | - | 最終更新日時 - ISO 8601形式 | | `CopyPartResult.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-29T08:10:32.000Z "d8c2eafd90c***********acc479f8af" ```