ニフクラAPI（オブジェクトストレージ：Put Object - Copy）

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.storage.api.nifcloud.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.storage.api.nifcloud.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>