コンテナ一覧取得

Description

コンテナ一覧を取得します。

Request URL

Object Storage API

GET /v1/AUTH_{tenantid}

Request Json

This operation does not accept a request body.

Request Parameters

Parameter	Value	Style	Description
X-Auth-Token	トークン	header	トークンの情報を指定します。トークンの発行方法は、トークン発行にてご確認ください。
reverse (Optional)	true	query	レスポンスされる並び順を降順にしたい場合に指定します。デフォルトはコンテナ名の昇順になります。
limit (Optional)	表示件数	query	取得する情報の表示件数を指定します。
marker (Optional)	任意の文字列	query	コンテナ名の開始文字列を指定します。指定した文字列から始まるコンテナ名のデータを確認したい場合に使用します。
end_marker (Optional)	任意の文字列	query	開始させたいコンテナ名の開始文字列の後に来る文字列を指定します。指定した文字列以前の文字列から始まるコンテナ名のデータを確認したい場合に使用します。
format (Optional)	json xml plain	query	レスポンスされる情報の形式を指定します。リクエスト時の「Accept」ヘッダーも指定する形式に揃える必要があります。
prefix (Optional)	接頭辞の文字列	query	コンテナの命名規則で接頭辞を設けている場合などに、そこで使用されている文字列を指定します。特定の文字列から始まるコンテナでフィルターをしたい場合に使用します。
delimiter (Optional)	区切り文字列	query	区切り文字列を指定します。「prefix」と併せて使用することで疑似的な階層としてデータを取得できます。

Response Code

Success

Example

Request

curl -X GET \
-H "Accept: application/json" \
-H "X-Auth-Token: トークン" \
https://object-storage.c3j1.conoha.io/v1/AUTH_テナントID

Response

[
	{
		"name": "コンテナ名",
		"count": 0,
		"bytes": 0
	}
]

ConoHaにて提供しておりますAPIにつきましては、クラウド基盤として採用しておりますOpenStackの機能にて実装しておりますので、詳細な情報や使い方はOpenStackのドキュメントにてご確認ください。