ボリューム一覧取得

Description

ボリュームの一覧を取得します。

Request URL

Volume API

GET /v3/{projectid}/volumes

Request Json

This operation does not accept a request body.

Request Parameters

Parameter	Value	Style	Description
X-Auth-Token	トークン	header	トークンの情報を指定します。トークンの発行方法は、トークン発行にてご確認ください。
projectid	テナントID	path	テナントIDを指定します。指定する情報は、API情報を確認するにてご確認ください。
limit (Optional)	表示件数	query	取得する情報の表示件数を指定します。
offset (Optional)	開始位置	query	取得する情報の開始位置を指定します。「limit」と併せて使用します。
marker (Optional)	「limit」クエリで応答された情報の最後の項目のID	query	「limit」クエリを実行後の応答結果から得られた最後の情報の次から改めて情報を取得したい場合に使用します。使用する際は、「limit」クエリで実行後の応答結果で得られる最後の項目のIDを指定します。「limit」と併せて使用します。
sort (Optional)	項目・並び順	query	ソート対象の項目と並び順を指定します。指定する際は、「項目:並び順」の形式になります。並び順は、「asc(昇順) 」または「desc(降順)」が指定できます。
with_count (Optional)	true false	query	レスポンス結果に対象の個数を含めたい場合に使用します。「true」もしくは「false」を指定します。指定しない場合のデフォルトは「false」になるため、個数を表示させたい場合は「true」をご指定してください。

Response Code

Success

Example

Request

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

Response

{
	"volumes": [
		{
			"id": "ボリュームID",
			"name": "win-2023-11-17-14-33",
			"links": [
				{
					"rel": "self",
					"href": "https://block-storage.c3j1.conoha.io/v3/テナントID/volumes/ボリュームID"
				},
				{
					"rel": "bookmark",
					"href": "https://block-storage.c3j1.conoha.io/テナントID/volumes/ボリュームID"
				}
			]
		}
	]
}

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