アカウントメタデータ取得 HEAD /v1/{account}
アカウントのメタデータを取得する
- コンテナ数
- オブジェクト数
- オブジェクトストレージの使用バイト数
- ユーザーが設定したカスタムメタデータ
オブジェクトストレージの使用バイト数を処理する際は、取り扱いに注意してください。オブジェクトストレージには大量のオブジェクトが格納できます。可能な限り64ビットの符号なし整数を使用するのをお勧めします。
本操作はリクエストボディを受け付けません。
リクエスト中にメタデータヘッダーを含んではいけません。
アカウントメタデータの取得に成功した場合、204ステータスコードが返却されます。
認証トークンが妥当なものではなかった場合、401ステータスコードが返却されます。
Request Headers
X-Auth-Token
認証トークン
Data Type | Cardinality |
---|---|
String | 1..1 |
X-Newest
Trueを設定すると、オブジェクトストレージはすべてのレプリカから最新のものを探して返却します。本ヘッダーを省略すると、オブジェクトストレージは正常なレプリカを一つ選んで返却します。本ヘッダーにTrueを指定することは非常に高コストとなります。絶対に必要な場合にだけ使用してください。
Data Type | Cardinality |
---|---|
Boolean | 0..1 |
Request Parameter
{account}
プロジェクト単位でユニークに割り当てられる名前
Data Type | Cardinality |
---|---|
String | 1..1 |
Response Headers
X-Account-Object-Count
アカウント内オブジェクトの総数
Data Type | Cardinality |
---|---|
Int | 1..1 |
X-Account-Container-Count
コンテナの総数
Data Type | Cardinality |
---|---|
Int | 1..1 |
X-Account-Bytes-Used
アカウントがオブジェクトストレージに格納したオブジェクトの合計サイズ
Data Type | Cardinality |
---|---|
Int | 1..1 |
X-Account-Meta-name
アカウントメタデータ。{name}はメタデータ項目の名前。
Data Type | Cardinality |
---|---|
String | 0..* |
X-Account-Meta-Temp-URL-Key
Temporary URLsのために使用する秘密鍵。設定していない場合はこのヘッダーは返却されません。
Data Type | Cardinality |
---|---|
String | 0..1 |
X-Account-Meta-Temp-URL-Key-2
Temporary URLsのために使用する2つ目の秘密鍵。設定していない場合はこのヘッダーは返却されません。
Data Type | Cardinality |
---|---|
String | 0..1 |
Content-Length
レスポンスボディのバイト数
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 HEAD -H "X-Auth-Token: $token"
Example of Response
HTTP/1.1 204 No Content
Content-Length: 0
X-Account-Object-Count: 1
X-Account-Meta-Book: MobyDick
X-Timestamp: 1389453423.35964
X-Account-Bytes-Used: 14
X-Account-Container-Count: 2
Content-Type: text/plain; charset=utf-8
Accept-Ranges: bytes
X-Trans-Id: txafb3504870144b8ca40f7-0052d955d4
Date: Fri, 17 Jan 2014 16:09:56 GMT