GetContainerList
- 印刷する
- PDF
GetContainerList
- 印刷する
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
概要
コンテナ(バケット)のリストを照会します。
注意
Subaccountの場合、Subaccount専用 External API Gatewayを通じて使用できます。
詳細は、Subaccountをご参照ください。
構文
GET v1/AUTH_{project_id}
リクエスト
リクエストパラメータ
Name | In | Type | Description |
---|---|---|---|
limit (Optional) | query | integer | 呼び出し結果の最大数制限 |
marker (Optional) | query | string | 特定コンテナ以降のリストをインポートする |
end_marker (Optional) | query | string | 特定コンテナ以前のリストをインポートする |
prefix (Optional) | query | string | 該当文字列で始まるコンテナリストを呼び出す |
reverse (Optional) | query | string | コンテナ名でソートしリストを出力 default : false (descending) |
X-Auth-Token (Optional) | header | string | 発行した Token値を入力 |
Accept (Optional) | header | string | 呼び出し結果のフォーマットを指定(application/json、application/xml、text/xml) |
レスポンス
レスポンスヘッダ
Name | In | Type | Description |
---|---|---|---|
X-Account-Meta-name | header | string | - 該当アカウントのメタデータ情報 - ヘッダ名の name 部分がメタデータのキーロールを果たす |
Content-Length | header | string | レスポンス結果の長さ(Bytes) |
X-Container-Object-Count | header | integer | 該当コンテナ(バケット)のオブジェクト数 |
X-Container-Bytes-Used | header | integer | 該当コンテナ(バケット)が使用する全体容量のサイズ(Bytes) |
X-Container-Meta-Temp-URL-Key (Optional) | header | string | temporary URLのための Secret Key値 |
X-Container-Meta-Temp-URL-Key-2 (Optional) | header | string | temporary URLのための2番目の Secret Key値 |
X-Timestamp | header | integer | 該当コンテナ(バケット)が作成された時刻(UNIX Time) |
X-Trans-Id | header | string | 該当リクエストのトランザクション ID |
X-Openstack-Request-Id | header | string | 該当リクエストのトランザクション ID(X-Trans-Idと同じ) |
Content-Type | header | string | レスポンス結果のフォーマット |
Date | header | string | 該当リクエストのレスポンス時間(UTC) |
レスポンスボディ
Name | In | Type | Description |
---|---|---|---|
name | body | string | 該当オブジェクト名 |
count | body | integer | 該当コンテナ(バケット)のオブジェクト数 |
bytes | body | integer | 該当コンテナ(バケット)が使用する全体容量のサイズ(Bytes) |
last_modified | body | string | 該当コンテナが最後に変更された時刻(UTC) |
例
リクエスト例(JSON)
curl -i -X GET -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}?format=json
レスポンス例
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
X-Openstack-Request-Id: tx274a77a8975c4a66aeb24-0052d95365
Date: Fri, 17 Jan 2014 15:59:33 GMT
[
{
"count": 0,
"bytes": 0,
"name": "janeausten",
"last_modified": "2013-11-19T20:08:13.283452"
},
{
"count": 1,
"bytes": 14,
"name": "marktwain",
"last_modified": "2016-04-29T16:23:50.460230"
}
]
リクエスト例(XML)
curl -i -X GET -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}?format=XML
レスポンス例
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
X-Openstack-Request-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>
<last_modified>2013-11-19T20:08:13.283452</last_modified>
</container>
<container>
<name>marktwain</name>
<count>1</count>
<bytes>14</bytes>
<last_modified>2016-04-29T16:23:50.460230</last_modified>
</container>
</account>
リクエストが成功すると、OK(200)、No Content(204)の状態コードを返します。
No Content(204)の場合は Content-Typeが plainであり、リクエストに該当する内容がない場合に発生します。
コンテナ(バケット)が存在しない場合、Not Found(403)状態コードを返します。
注意
SubAccountの場合、 SubAccount専用リスト照会 API を使用する必要があります。
この記事は役に立ちましたか?