オブジェクトメタデータ更新 POST /v1/{account}/{container}/{object}
オブジェクトのメタデータを作成または、更新する
X-Object-Meta-{name}ヘッダーを使って、カスタムメタデータの作成更新を行う。{name}には、カスタムメタデータの名前が入る。
カスタムメタデータは以前に付与していたものは全て削除される。POST 要求では必要なカスタムメタデータを再作成する必要がある。
システムメタデータは更新されない。
ただし、Content-Type,Content-Encoding,Content-Disposition,X-Delete-At の4つは更新する事ができる。これらは、リクエストヘッダーで指定しない限り、変更されない。
Normal response codes: 202
Request Headers
X-Auth-Token
認証トークン。
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
X-Object-Meta-name
コンテナのメタデータ。{name}はメタデータの名前。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Delete-At
オブジェクトが削除される日をUNIX Epochタイムスタンプの形式で指定する。
| Data Type | Cardinality |
|---|---|
| Int | 0..1 |
Content-Disposition
ブラウザの振る舞いを設定します。
設定する値については、http://www.ietf.org/rfc/rfc2183.txtをご参照ください。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
Content-Encoding
Content-Encodingのメタデータを指定する。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Delete-After
オブジェクトを削除するまでの経過時間を指定する。
内部的には、Object Storage systemは、この値を"X-Delete-At"のメタデータとして保持する
| Data Type | Cardinality |
|---|---|
| Int | 0..1 |
Content-Type
オブジェクトのMIME typeを変更する。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Detect-Content-Type
オブジェクトのContent-Type自動検出を指定する。
このヘッダーにTrueが指定された場合、Content-Typeヘッダーの指定は無視され、ファイル拡張子からcontent typeを推定する。
| Data Type | Cardinality |
|---|---|
| Boolean | 0..1 |
Request Parameter
{account}
アカウントのuniqueな名前。"アカウント"は、"プロジェクト"とも呼ばれる。
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
{container}
コンテナのuniqueな名前。
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
{object}
オブジェクトのuniqueな名前。
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
Response Headers
Content-Length
操作が成功した場合、この値は0。 操作が失敗した場合、response body に格納されたerror text の長さ。
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
Content-Type
オブジェクトのMIME typeの種類。
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
X-Trans-Id
このリクエストに付与されるID。トラブルについて問い合わせる際に利用されます。
| Data Type | Cardinality |
|---|---|
| Uuid | 1..1 |
Date
トランザクションの日時情報。
| Data Type | Cardinality |
|---|---|
| Datetime | 1..1 |
Response Elements
作成されたことを示すHtmlコンテンツが返却されます。
オブジェクトメタデータの作成
Example of Request
curl -i $publicURL/marktwain/goodbye -X POST -H "X-Auth-Token:$token" -H "X-Object-Meta-Book: GoodbyeColumbus"
Example of Response
HTTP/1.1 202 Accepted
Content-Length: 76
Content-Type: text/html; charset=UTF-8
X-Trans-Id: txb5fb5c91ba1f4f37bb648-0052d84b3f
Date: Thu, 16 Jan 2014 21:12:31 GMT
<html><h1>Accepted</h1><p>The request is accepted for processing.</p></html>
オブジェクトメタデータの更新
Example of Request
curl -i $publicURL/marktwain/goodbye -X POST -H "X-Auth-Token:$token" -H "X-Object-Meta-Book: GoodbyeOldFriend"
Example of Response
HTTP/1.1 202 Accepted
Content-Length: 76
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx5ec7ab81cdb34ced887c8-0052d84ca4
Date: Thu, 16 Jan 2014 21:18:28 GMT
<html><h1>Accepted</h1><p>The request is accepted for processing.</p></html>