オブジェクト複製 COPY /v1/{account}/{container}/{object}
オブジェクトを複製する。
PUT オブジェクトでX-Copy-Fromを指定した場合と同じ動作になります。
この操作を使ってマニフェストオブジェクトをコピーする場合、新しいオブジェクトは、すべてのセグメントを結合した通常オブジェクトになります。従って、結合サイズが5GBを超えるようなオブジェクトをコピーすることはできません。
メタデータは複製元オブジェクトと同様のものが付与されます。リクエストの際にメタデータを指定した場合は、複製後に、複製先のオブジェクトのメタデータを更新します。
オブジェクトの作成に成功した場合、201 Createdステータスコードを返却します。
Request Headers
X-Auth-Token
認証トークン
Data Type | Cardinality |
---|---|
String | 1..1 |
Destination
コピー先コンテナ名およびオブジェクト名を/{container}/{object}の形式で指定します。また、コンテナ名およびオブジェクト名はUTF-8エンコードをしてからさらにURLエンコードしたものをヘッダーに設定する必要があります。
Data Type | Cardinality |
---|---|
String | 1..1 |
Content-Type
オブジェクトのMIMEタイプ
Data Type | Cardinality |
---|---|
String | 0..1 |
Content-Encoding
Content-Encodingメタデータを設定します。
Data Type | Cardinality |
---|---|
String | 0..1 |
Content-Disposition
ブラウザの振る舞いを設定します。
設定する値については、http://www.ietf.org/rfc/rfc2183.txtをご参照ください。
Data Type | Cardinality |
---|---|
String | 0..1 |
X-Object-Meta-name
オブジェクトメタデータ。{name}はメタデータ項目の名前。
Data Type | Cardinality |
---|---|
String | 0..1 |
Request Parameter
{account}
プロジェクト単位でユニークに割り当てられる名前
Data Type | Cardinality |
---|---|
String | 1..1 |
{container}
コンテナ名
Data Type | Cardinality |
---|---|
String | 1..1 |
{object}
オブジェクト名
Data Type | Cardinality |
---|---|
String | 1..1 |
Response Headers
X-Copied-From-Last-Modified
コピー元オブジェクトの最終更新日と時間
Data Type | Cardinality |
---|---|
String | 0..1 |
X-Copied-From
コピー元オブジェクトのコンテナ名およびオブジェクト名。{container}/{object}の形式で返却されます。
Data Type | Cardinality |
---|---|
String | 0..1 |
Last-Modified
オブジェクトの作成日と時間またはメタデータが変更された日と時間
Data Type | Cardinality |
---|---|
String | 1..1 |
ETag
オブジェクトのMD5チェックサム。この値は引用符で囲まれません。
Data Type | Cardinality |
---|---|
String | 1..1 |
Content-Type
オブジェクトのMIMEタイプ
Data Type | Cardinality |
---|---|
String | 1..1 |
X-Object-Meta-name
オブジェクトメタデータ。{name}はメタデータ項目の名前。
Data Type | Cardinality |
---|---|
String | 0.. |
X-Trans-Id
このリクエストに付与されるID。トラブルについて問い合わせる際に利用されます。
Data Type | Cardinality |
---|---|
Uuid | 1..1 |
Date
トランザクションの実行された日付と時間
Data Type | Cardinality |
---|---|
Datetime | 1..1 |
Response Elements
特にありません
COPYの場合
Example of Request
curl -i $publicURL/marktwain/goodbye -X COPY -H "X-Auth-Token:$token" -H "Destination: janeausten/goodbye"
Example of Response
HTTP/1.1 201 Created
Content-Length: 0
X-Copied-From-Last-Modified: Thu, 16 Jan 2014 21:19:45 GMT
X-Copied-From: marktwain/goodbye
Last-Modified: Fri, 17 Jan 2014 18:22:57 GMT
Etag: 451e372e48e0f6b1114fa0724aa79fa1
Content-Type: text/html; charset=UTF-8
X-Object-Meta-Movie: AmericanPie
X-Trans-Id: txdcb481ad49d24e9a81107-0052d97501
Date: Fri, 17 Jan 2014 18:22:57 GMT
(参考) PUTで"X-Copy-From"ヘッダーを使ったコピーの場合
Example of Request
curl -i $publicURL/janeausten/goodbye -X PUT -H "X-Auth-Token: $token" -H "X-Copy-From: /marktwain/goodbye" -H "Content-Length: 0"
Example of Response
HTTP/1.1 201 Created
Content-Length: 0
X-Copied-From-Last-Modified: Thu, 16 Jan 2014 21:19:45 GMT
X-Copied-From: marktwain/goodbye
Last-Modified: Fri, 17 Jan 2014 18:22:57 GMT
Etag: 451e372e48e0f6b1114fa0724aa79fa1
Content-Type: text/html; charset=UTF-8
X-Object-Meta-Movie: AmericanPie
X-Trans-Id: txdcb481ad49d24e9a81107-0052d97501
Date: Fri, 17 Jan 2014 18:22:57 GMT