CopyObject

Prev Next

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

Ncloud Storageバケットに保存されているオブジェクトをコピーして保存します。最大5GBのオブジェクトまでコピーできます。

リクエスト

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

メソッド URI
PUT /{Key}

リクエストヘッダ

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

参考

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

フィールド 必須の有無 説明
x-amz-copy-source Required コピー対象のオブジェクト
  • {バケット名}/{オブジェクト名}形式で入力<ul><li>バケット名: [ListBuckets](/docs/ja/ncloudstorage-listbuckets)を参照</li><li>オブジェクト名: [ListObjectsV2](/docs/ja/ncloudstorage-listobjectsv2)を参照</li><li><例>bucket000/object000.csv</li></ul></li><li>バージョン管理が設定されたバケットでオブジェクトの特定のバージョンをコピーする場合、入力値に?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-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 オブジェクトコピーの名前
  • バケット内フォルダに保存する場合、{フォルダ名}/{ファイル名}形式で入力

リクエスト例

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

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

レスポンスボディ

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

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

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

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

レスポンス例

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

HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<CopyObjectResult>
    <LastModified>2025-04-28T09:36:57Z</LastModified>
    <ETag>"2dd********************4f6181"</ETag>
</CopyObjectResult>