本文へジャンプします。

ニフティクラウド APIリファレンス

Put Object - Copy

処理概要

指定したオブジェクトを任意のバケットにコピーします。

アクセス権限はコピー元オブジェクト、コピー先バケットの権限に依存します。
以下の場合のみコピー可能となります。

  • コピー元オブジェクトに対し、読み込み権限がある
  • コピー先バケットに対し、書き込み権限がある

x-amz-metadata-directiveヘッダーにREPLACEを指定した場合、コピー元オブジェクトに登録されていたメタデータは引き継がれず、x-amz-meta-ヘッダーで指定したメタデータのみが登録されます。
REPLACEを指定し、x-amz-meta-ヘッダーを指定しなかった場合、メタデータは何も登録されません。

サイズの大きいオブジェクトをコピーする場合、処理に時間がかかることがあります。その間にタイムアウトなどで接続が切断されてしまった場合、応答を受け取ることができませんので、ご注意ください。

バージョン管理

コピー先バケットにバージョニング設定がされている場合、コピー先オブジェクトはバージョン管理されます。
また、コピー元バケットがバージョニング設定されている場合、コピー元オブジェクトのversionIdを指定することで特定バージョンのコピーが行えます。

指定するパラメーター

パラメーター 説明 必須 サンプル値
versionId オブジェクトのバージョンID
Type : int
  999122348912293847

指定するヘッダー

パラメーター 説明 必須 サンプル値
x-amz-acl CannedACL
Type : String
Default : private
値 : private | public-read | authenticated-read
   
x-amz-copy-source コピー元オブジェクトのロケーション
Type : String
/bucket/sample.txt
x-amz-metadata-directive メタデータのコピー方式
コピーするか、設定したメタデータで置き換えるかを指定
Type : String
Default : COPY
値 : COPY | REPLACE
   
x-amz-meta- オブジェクトのメタデータ
x-amz-metadata-directiveにREPLACEを指定した場合のみ有効です。
Type : String
   

指定するボディ

必要なボディはありません。

応答フィールド

フィールド 説明 サンプル値
CopyObjectResult CopyObjectResultレスポンス
Type : Container
Ancestor : なし
Children : ETag, LastModified
 
ETag オブジェクトETag
Type : xsd:string
Ancestor : CopyObjectResult
Children : なし
 
LastModified 最新更新時間
Type : xsd:date
Ancestor : CopyObjectResult
Children : なし
2012-01-17T00:00:00.245Z

リクエストサンプル(コピー元オブジェクトのversionId指定なし)

PUT /sample-copy.txt HTTP/1.1
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 00:00:00 GMT
x-amz-copy-source: /my-first-bucket/sample.txt
x-amz-metadata-directive: REPLACE
Authorization: AWS 07cbb45fc128390123f4:jUgOMOxiuSXIn1MX6NPlpASWsAk=
Content-Length: 0
Content-Type: application/x-form-urlencoded; charset=utf-8
x-amz-meta-alphabet: abcdefghijklmnopqrstuvwxyz

リクエストサンプル(コピー元オブジェクトのversionId指定あり)

PUT /sample-copy.txt HTTP/1.1
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 00:00:00 GMT
x-amz-acl: private
x-amz-copy-source: /my-first-bucket/sample.txt?versionId=999122348912293847
x-amz-metadata-directive: REPLACE
Authorization: AWS 07cbb45fc128390123f4:jUgOMOxiuSXIn1MX6NPlpASWsAk=
Content-Length: 0
Content-Type: application/x-form-urlencoded; charset=utf-8
x-amz-meta-alphabet: abcdefghijklmnopqrstuvwxyz

応答サンプル

HTTP/1.0 200 OK
Date: Wed, 29 Jun 2016 00:00:00 GMT
x-amz-request-id: 025c3b8d-934a-38f3-ae0f-1ab2d417b514
x-amz-version-id: 998668733996176
Content-Type: application/xml;charset=UTF-8
Content-Length: 185
 <CopyObjectResult>
  <LastModified>2012-01-17T00:00:00.245Z</LastModified>
  <ETag>&quot;6984c2483f45718ba145956e46018834&quot;</ETag>
 </CopyObjectResult>

推奨画面サイズ 1024×768 以上