PutObject (Copy)

Prev Next

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

指定したヘッダを利用してオブジェクトのコピーを作成します。オペレーションに使用されるリクエストクエリパラメータ、リクエストボディはありません。

参考
  • コピーを変更しない限り、コピーのメタデータはソースと同じままです。ただし、コピーを作成したアカウントに適用された ACL設定は、privateに再設定されます。

リクエスト

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

メソッド URI
PUT /{bucket-name}/{object-name}

リクエスト構文

リクエスト構文は次の通りです。

PUT https://{endpoint}/{bucket-name}/{object-name} # path style
PUT https://{bucket-name}.{endpoint}/{object-name} # virtual host style

リクエストヘッダ

PutObject (Copy)ヘッダを紹介します。Object Storage APIリクエストで共通して使用されるヘッダの詳細は、Object Storage共通リクエストヘッダをご参照ください。

フィールド タイプ 必須の有無 説明
x-amz-metadata-directive String Optional ソースメタデータの変更を設定
  • COPY | REPLACE
    • REPLACE入力時に提供される新しいメタデータでソースメタデータを上書きする
x-amz-copy-source-if-match String Optional 指定した ETag文字列がソースオブジェクトと一致する場合、コピーを作成
x-amz-copy-source-if-none-match String Optional 指定した ETag文字列がソースオブジェクトと異なる場合、コピーを作成
x-amz-copy-source-if-unmodified-since String Optional 指定した日付以降にソースオブジェクトを変更しなかった場合、コピーを作成
  • 有効な日付形式であることが必要
    • <例> Wed, 30 Nov 2016 20:21:38 GMT
x-amz-copy-source-if-modified-since String Optional 指定した日付以降にソースオブジェクトを変更した場合、コピーを作成
  • 有効な日付形式であることが必要
    • <例> Wed, 30 Nov 2016 20:21:38 GMT

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

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

フィールド タイプ 必須の有無 説明
bucket-name String Required オブジェクトのコピーを作成するバケットの名前
object-name String Required コピーするオブジェクトの名前

リクエスト例

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

PUT /example-bucket/wild-bee HTTP/1.1
Authorization: {authorization-string}
x-amz-date: 20161130T195251Z
x-amz-copy-source: /garden/bee
Host: kr.object.ncloudstorage.com

レスポンス

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

レスポンスヘッダ

Object Storage APIで共通して使用されるレスポンスヘッダの詳細は、Object Storageの共通レスポンスヘッダをご参照ください。

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

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

レスポンス例

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

HTTP/1.1 200 OK
Date: Wed, 30 Nov 2016 19:52:52 GMT
Accept-Ranges: bytes
x-amz-request-id: 72992a90-8f86-433f-b1a4-7b1b33714bed
ETag: "853aab195ce770b0dfb294a4e9467e62"
Content-Type: application/xml
Content-Length: 240

<CopyObjectResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <LastModified>2016-11-30T19:52:53.125Z</LastModified>
  <ETag>"853aab195ce770b0dfb294a4e9467e62"</ETag>
</CopyObjectResult>