アカウントメタデータ更新 POST /v1/{account}
アカウントのメタデータを作成、更新、または削除する
X-Account-Meta-{name}ヘッダーを使ってメタデータを作成、更新、削除します。{name}はメタデータ項目の名前です。
既存のメタデータと同名の{name}を指定すると、上書きされます。
メタデータを削除するには、空の値を設定したヘッダーでリクエストしてください。もしくは、X-Remove-Account-Meta-{name}: arbitrary valueヘッダーを使用してください。例えばX-Remove-Account-Meta-Book: x のようにします。arbitrary valueの部分は無視されます。
既存のメタデータのうち、本APIで指定したもの以外は更新されません。
リクエストボディは受け付けません。
アカウントメタデータの更新に成功した場合、204ステータスコードが返却されます。
変更を確認するためには、アカウントメタデータ取得リクエストを行ってください。
Request Headers
X-Auth-Token
認証トークン
Data Type | Cardinality |
---|---|
String | 1..1 |
X-Account-Meta-Temp-URL-Key
Temporary URLsのために使用する秘密鍵。
Data Type | Cardinality |
---|---|
String | 0..1 |
X-Account-Meta-Temp-URL-Key-2
Temporary URLsのために使用する2つ目の秘密鍵。2つの鍵を使用することで、鍵のローテーション処理が可能になります。
Data Type | Cardinality |
---|---|
String | 0..1 |
X-Account-Meta-name
アカウントメタデータ。{name}に作成,更新,削除したいメタデータ項目の名前を指定します。項目を削除する場合は、ヘッダーに空の値を指定します。
Data Type | Cardinality |
---|---|
String | 0..* |
Request Parameter
{account}
プロジェクト単位でユニークに割り当てられる名前
Data Type | Cardinality |
---|---|
String | 1..1 |
Response Headers
Content-Length
リクエストが成功すると値は0になります。失敗すると、レスポンスボディに含まれるエラーテキストのバイトサイズが値に設定されます。
Data Type | Cardinality |
---|---|
String | 1..1 |
Content-Type
リクエストが失敗すると、レスポンスボディに含まれるエラーテキストのMIMEタイプが設定されます。
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
特にありません。
アカウントメタデータの作成
Example of Request
curl -i $publicURL -X POST -H "X-Auth-Token: $token" -H "X- Account-Meta-Book: MobyDick" -H "X-Account-Meta-Subject: Literature"
Example of Response
HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx8c2dd6aee35442a4a5646-0052d954fb
Date: Fri, 17 Jan 2014 16:06:19 GMT
アカウントメタデータの更新
Example of Request
curl -i $publicURL -X POST -H "X-Auth-Token: $token" -H "X-Account-Meta-Subject: AmericanLiterature"
Example of Response
HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx1439b96137364ab581156-0052d95532
Date: Fri, 17 Jan 2014 16:07:14 GMT
アカウントメタデータの削除
Example of Request
curl -i $publicURL -X POST -H "X-Auth-Token: $token" -H "X-Remove-Account-Meta-Subject: x"
Example of Response
HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx411cf57701424da99948a-0052d9556f
Date: Fri, 17 Jan 2014 16:08:15 GMT