アカウントメタデータ取得 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