コンテナメタデータ取得HEAD /v1/{account}/{container}
コンテナに格納されているすべてのオブジェクトの合計バイト数とオブジェクトの数を含むコンテナのメタデータを取得する
コンテナメタデータの取得に成功した場合、204ステータスコードが返却されます。
Request Headers
X-Auth-Token
認証トークン。省略した場合、ACLによってアクセスを許可していない限り、リクエストは失敗します。詳細についてはACLをご参照ください。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Newest
Trueを設定すると、オブジェクトストレージはすべてのレプリカから最新のものを探して返却します。本ヘッダーを省略すると、オブジェクトストレージは正常なレプリカを一つ選んで返却します。本ヘッダーにTrueを指定することは非常に高コストとなります。絶対に必要な場合にだけ使用してください。
| Data Type | Cardinality |
|---|---|
| Boolean | 0..1 |
Request Parameter
{account}
プロジェクト単位でユニークに割り当てられる名前
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
{container}
コンテナ名
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
Response Headers
Content-Length
レスポンスボディのバイト数
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
X-Container-Object-Count
コンテナ内オブジェクトの総数
| Data Type | Cardinality |
|---|---|
| Int | 1..1 |
X-Container-Meta-name
コンテナメタデータ。{name}はメタデータ項目の名前。
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
X-Container-Bytes-Used
コンテナ内オブジェクトの合計バイトサイズ
| Data Type | Cardinality |
|---|---|
| Int | 1..1 |
X-Container-Read
リード権限のACL。設定されていない場合は返却されません。詳細は、リード権限をご参照ください。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Container-Write
ライト権限のACL。設定されていない場合は返却されません。詳細は、ライト権限をご参照ください。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Versions-Location
コンテナ内オブジェクトのバージョニング設定。設定されていない場合は返却されません。
| Data Type | Cardinality |
|---|---|
| String | 0..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 |
X-Container-Meta-Web-Index
Indexファイルのオブジェクト名。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Container-Meta-Web-Error
Errorページファイルのオブジェクト名。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Container-Meta-Web-Listing
ディレクトリ一覧表示が有効な場合、Trueが返却されます。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Container-Meta-Web-Listing-CSS
ディレクトリ一覧表示用のスタイルシートのオブジェクト名。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
Response Elements
特にありません。
Example of Request
curl -i $publicURL/marktwain -X HEAD -H "X-Auth-Token: $token"
Example of Response
HTTP/1.1 204 No Content
Content-Length: 0
X-Container-Object-Count: 1
Accept-Ranges: bytes
X-Container-Meta-Book: TomSawyer
X-Timestamp: 1389727543.65372
X-Container-Meta-Author: SamuelClemens
X-Container-Bytes-Used: 14
Content-Type: text/plain; charset=utf-8
X-Trans-Id: tx0287b982a268461b9ec14-0052d826e2
Date: Thu, 16 Jan 2014 18:37:22 GMT