コンテナ一覧取得 GET /v1/{account}{?limit,marker,end_marker, format,prefix,delimiter}
アカウントの詳細とリストコンテナを取得する
形式を指定しない場合は、text/plain形式でコンテナ一覧が取得されます。
また、クエリパラメーターを使用すると、コンテナのリストをページに分けて取得できます。取得したコンテナの数が、limitパラメーターで指定した値より少ない場合、リストは最後まで取得されています。取得したコンテナの数が、limitパラメーターで指定した値と等しい場合、リストにはまだ未取得のコンテナが残っています。
- 200 OK. レスポンスボディにコンテナ一覧が含まれる場合に返却されます。
- 204 No Content コンテナが存在しない場合やlimit,marker,end_markerのクエリパラメーターを使ってフィルタリングしたコンテナ一覧のサブセットが空の場合に返却されます。
Request Headers
X-Auth-Token
認証トークン
Data Type | Cardinality |
---|---|
String | 1..1 |
X-Newest
Trueを設定すると、オブジェクトストレージはすべてのレプリカから最新のレプリカを探して返却します。本ヘッダーを省略すると、オブジェクトストレージは正常なレプリカを一つ選んで返却します。本ヘッダーにTrueを指定すると、応答時間が長くなります。絶対に必要な場合にだけ使用してください。
Data Type | Cardinality |
---|---|
Boolean | 0..1 |
Accept
application/json, application/xml, text/xmlを設定できます。
Data Type | Cardinality |
---|---|
String | 0..* |
Request Parameter
{account}
プロジェクト単位でユニークに割り当てられる名前
Data Type | Cardinality |
---|---|
String | 1..1 |
limit
一度に取得できるコンテナの最大数
任意の数値(1~10000)を指定すると、その数値分の一覧を返却します。デフォルトは10000です。
Data Type | Cardinality |
---|---|
Int | 0..1 |
marker
指定した文字列より後のコンテナ名一覧を返却します。
Data Type | Cardinality |
---|---|
String | 0..1 |
end_marker
指定した文字列より前のコンテナ名一覧を返却します。
Data Type | Cardinality |
---|---|
String | 0..1 |
format
レスポンスのフォーマットを指定します。json,xml,plainから選択できます。デフォルトはplainです。
format=xmlまたはformat=jsonをクエリパラメーターに追加すると、コンテナ名だけでなく、コンテナの詳細情報を含む結果を取得します。
format=plain をクエリパラメーターに指定すると、改行区切りでコンテナ名の一覧を取得します。
Data Type | Cardinality |
---|---|
String | 0..1 |
prefix
この文字列から始まるコンテナの一覧を返却します。
Data Type | Cardinality |
---|---|
String | 0..1 |
Response Headers
Content-Length
レスポンスボディのバイト数
Data Type | Cardinality |
---|---|
String | 1..1 |
Content-Type
レスポンスボディのMIMEタイプ。
Data Type | Cardinality |
---|---|
String | 1..1 |
X-Account-Object-Count
アカウント内オブジェクトの総数
Data Type | Cardinality |
---|---|
Int | 1..1 |
X-Account-Bytes-Used
アカウントがオブジェクトストレージに格納したオブジェクトの合計バイトサイズ
Data Type | Cardinality |
---|---|
Int | 1..1 |
X-Account-Container-Count
コンテナの総数
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 |
X-Trans-Id
このリクエストに付与されるID。トラブルについて問い合わせる際に利用されます。
Data Type | Cardinality |
---|---|
Uuid | 1..1 |
Date
トランザクションの実行された日付と時間
Data Type | Cardinality |
---|---|
Datetime | 1..1 |
Response Elements
account
レスポンスのエンベロープ
Data Type | Cardinality | Parent Element | Child Element(s) |
---|---|---|---|
account | 1..1 | None | container |
container
コンテナ情報の一式
Data Type | Cardinality | Parent Element | Child Element(s) |
---|---|---|---|
container | 0..n | account | name
count bytes |
name
コンテナ名
Data Type | Cardinality | Parent Element | Child Element(s) |
---|---|---|---|
string | 0..n | container | None |
count
コンテナが保有するオブジェクト数
Data Type | Cardinality | Parent Element | Child Element(s) |
---|---|---|---|
string | 0..1 | container | None |
bytes
コンテナが保有するオブジェクト数の総サイズ
Data Type | Cardinality | Parent Element | Child Element(s) |
---|---|---|---|
string | 0..1 | container | None |
Example List containers response: HTTP and JSON
Example of Request
curl -i $publicURL?format=json -X GET -H "X-Auth-Token: $token"
Example of Response
HTTP/1.1 200 OK
Content-Length: 96
X-Account-Object-Count: 1
X-Timestamp: 1389453423.35964
X-Account-Meta-Subject: Literature
X-Account-Bytes-Used: 14
X-Account-Container-Count: 2
Content-Type: application/json; charset=utf-8
Accept-Ranges: bytes
X-Trans-Id: tx274a77a8975c4a66aeb24-0052d95365
Date: Fri, 17 Jan 2014 15:59:33 GMT
[
{
"count": 0,
"bytes": 0,
"name": "janeausten"
},
{
"count": 1,
"bytes": 14,
"name": "marktwain"
}
]
Example List containers response: HTTP and XML
Example of Request
curl -i $publicURL?format=xml -X GET -H "X-Auth-Token: $token"
Example of Response
HTTP/1.1 200 OK
Content-Length: 262
X-Account-Object-Count: 1
X-Timestamp: 1389453423.35964
X-Account-Meta-Subject: Literature
X-Account-Bytes-Used: 14
X-Account-Container-Count: 2
Content-Type: application/xml; charset=utf-8
Accept-Ranges: bytes
X-Trans-Id: tx69f60bc9f7634a01988e6-0052d9544b
Date: Fri, 17 Jan 2014 16:03:23 GMT
<?xml version="1.0" encoding="UTF-8"?>
<account name="my_account">
<container>
<name>janeausten</name>
<count>0</count>
<bytes>0</bytes>
</container>
<container>
<name>marktwain</name>
<count>1</count>
<bytes>14</bytes>
</container>
</account>