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>"6984c2483f45718ba145956e46018834"</ETag>
</CopyObjectResult>