本文へジャンプします。

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

Put Object - Copy

処理概要

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

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

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

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

コピーが開始されるとステータスコード200が返却され、その後コピー処理が完了すると応答フィールドが返却されます。処理に失敗した場合は応答フィールドとしてエラーレスポンスが返却されます。

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

バージョン管理

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

指定するパラメーター

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

指定するヘッダー

パラメーター 説明 必須 サンプル値
x-nifty-acl CannedACL
Type : String
Default : private
値 : private | public-read | authenticated-read
   
x-nifty-copy-source コピー元オブジェクトのロケーション
Type : String
/bucket/sample.txt
x-nifty-metadata-directive メタデータのコピー方式
コピーするか、設定したメタデータで置き換えるかを指定します。
Type : String
Default : COPY
値 : COPY | REPLACE
   
x-nifty-meta- オブジェクトのメタデータ
x-nifty-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.ncss.nifty.com
Date: Tue, 17 Jan 2012 00:00:00 GMT
x-nifty-copy-source: /my-first-bucket/sample.txt
x-nifty-metadata-directive: REPLACE
Authorization: NIFTY 07cbb45fc128390123f4:jUgOMOxiuSXIn1MX6NPlpASWsAk=
Content-Length: 0
Content-Type: application/x-form-urlencoded; charset=utf-8
x-nifty-meta-alphabet: abcdefghijklmnopqrstuvwxyz

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

PUT /sample-copy.txt HTTP/1.1
Host: my-first-bucket.ncss.nifty.com
Date: Tue, 17 Jan 2012 00:00:00 GMT
x-nifty-acl: private
x-nifty-copy-source: /my-first-bucket/sample.txt?versionId=999122348912293847
x-nifty-metadata-directive: REPLACE
Authorization: NIFTY 07cbb45fc128390123f4:jUgOMOxiuSXIn1MX6NPlpASWsAk=
Content-Length: 0
Content-Type: application/x-form-urlencoded; charset=utf-8
x-nifty-meta-alphabet: abcdefghijklmnopqrstuvwxyz

応答サンプル

HTTP/1.0 200 OK
Date: Mon, 05 Mar 2012 00:29:38 GMT
x-nifty-request-id: 025c3b8d-934a-38f3-ae0f-1ab2d417b514
x-nifty-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>
  • ※コピー先バケットがバージョニング設定されていない場合、x-nifty-version-id:はnullとなります。

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