CopyObject

Prev Next

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

他の場所にあるオブジェクトをコピーしてアップロードします。

リクエスト

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

メソッド URI
COPY /v1/AUTH_{project_id}/{container}/{object}

リクエストヘッダ

ヘッダの説明は次の通りです。

フィールド タイプ 必須の有無 説明
X-Auth-Token String Optional 発行したトークンの値
Destination String Required コピーを保存するパス
  • 入力形式: {container}/{object}
X-Object-Meta-{name} String Optional 設定するメタデータ
  • {name}部分にメタデータのキーを入力
  • ヘッダにメタデータの値を入力
  • メタデータの追加、アップデート、削除が可能
  • 削除リクエスト時は空の値に設定
X-Fresh-Metadata Boolean Optional メタデータをコピーするかどうか
  • true | false (デフォルト)
    • true: メタデータをコピーしない
    • false: メタデータをコピー
Content-Disposition String Optional ブラウザのレスポンス処理方式
Content-Encoding String Optional オブジェクトのエンコード方式
Content-Type String Optional オブジェクトの MIMEタイプ

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

パラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
project_id String Required プロジェクト ID
container String Required 対象のオブジェクトが保存されるコンテナの名前
object String Required コピーする対象オブジェクトの名前

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

パラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
multipart-manifest String Conditional 大容量オブジェクトのマルチパートアップロードを宣言
  • 値としてgetを入力するとマルチパートアップロードとして認識
  • オブジェクト自体ではなく、マニフェストがコピーされる

リクエスト例

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

curl -L -X COPY 'https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}' \
-H 'X-Auth-Token: {token}' \
-H 'X-Object-Meta-collection: C5' \
-H 'Destination: {container}/{object name}' \
-H 'X-Fresh-Metadata: true'

レスポンス

レスポンス形式を説明します。

レスポンスヘッダ

ヘッダの説明は次の通りです。

フィールド タイプ 必須の有無 説明
Content-Type String - レスポンス結果の MIMEタイプ
Content-Length String - レスポンス結果の長さ(Byte)
ETag String - ETagヘッダの値
Last-Modified String - オブジェクトの最終更新時間(UTC)
X-Copied-From-Account String - ソースオブジェクトのアカウント(プロジェクト ID)
X-Copied-From String - ソースオブジェクトのパス
  • 形式:{container}/{object}
X-Copied-From-Last-Modified String - ソースオブジェクトのLast-Modifiedヘッダの値
X-Object-Meta-{name} String - オブジェクトのメタデータ
  • {name}部分がメタデータのキー
  • ヘッダの値がメタデータの値
X-Trans-Id String - リクエストのトランザクション ID
X-Openstack-Request-Id String - リクエストのトランザクション ID
  • X-Trans-Idと同じ
Date String - リクエストのレスポンスタイム(UTC)

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

レスポンスステータスコードの説明は次の通りです。

HTTPステータスコード コード メッセージ 説明
201 - Created リクエスト成功

レスポンス例

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

HTTP/1.1 201 Created
Last-Modified: Mon, 17 Sep 2018 08:21:36 GMT
Content-Length: 0
Etag: f1c9645dbc14efddc7d8a322685f26eb
Content-Type: text/html; charset=UTF-8
X-Copied-From-Account: AUTH_{project_id}
X-Copied-From-Last-Modified: Mon, 17 Sep 2018 07:43:40 GMT
X-Copied-From: ncloud-container-0/ncloud-object-0
X-Trans-Id: tx851b895d7fcf47f987a5a-005b9f640f
X-Openstack-Request-Id: tx851b895d7fcf47f987a5a-005b9f640f
Date: Mon, 17 Sep 2018 08:21:35 GMT