UploadPartCopy

Prev Next

Classic/VPC環境で利用できます。

Ncloud Storageバケットに保存されているオブジェクトをコピーして、マルチパートアップロードのパートでアップロードします。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
PUT /{Key}

リクエストヘッダ

リクエストヘッダの説明は次の通りです。

参考

Ncloud Storage APIで共通して使用されるヘッダの詳細は、Ncloud Storageのリクエストヘッダをご参照ください。

フィールド 必須の有無 説明
x-amz-copy-source Required コピー対象のオブジェクト
  • {バケット名}/{オブジェクト名}形式で入力
  • <例> bucket/object.csv
  • バージョン管理が設定されたバケットでオブジェクトの特定のバージョンをコピーする場合、入力値に?versionId={versionId}を追加
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 (デフォルト) | DEEP_ARCHIVE
    • STANDARD: Standard 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 オブジェクト名

リクエストクエリパラメータ

リクエストクエリパラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
partNumber Integer Required パート番号
  • 1~10,000
uploadId String Required マルチパートアップロード ID

リクエスト例

リクエストのサンプルコードは次の通りです。

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のレスポンスヘッダをご参照ください。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
CopyPartResult Object - オブジェクトのコピーのマルチパートアップロードの結果
CopyPartResult.LastModified String - 最終更新日時
  • ISO 8651形式
CopyPartResult.ETag String - オブジェクトの固有 ID(Entity Tag)

レスポンスステータスコード

Ncloud Storage APIで共通して使用されるレスポンスステータスコードの詳細は、Ncloud Storageのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

HTTP/1.1 200 OK
<CopyPartResult>
    <LastModified>2025-04-29T08:10:32.000Z</LastModified>
    <ETag>&#34;d8c2eafd90c***********acc479f8af&#34;</ETag>
</CopyPartResult>