Description
作成済みVMの一覧を取得します。
Request URL
Compute API
GET /v2/{tenant_id}/servers
Request Json
This operation does not accept a request body.
Request Parameters
| Parameter | Value | Style | Description |
|---|---|---|---|
| X-Auth-Token | トークンID | header | トークンIDを指定します。 |
| tenant_id | テナントID | path | テナントIDを指定します。 |
| limit(Optional) | 表示件数 | query | 取得する情報の表示件数を指定します。 |
| marker(Optional) | 「limit」クエリで応答された情報の最後の項目のID | query | 「limit」クエリを実行後の応答結果から得られた最後の情報の次から改めて情報を取得したい場合に使用します。使用する際は、「limit」クエリで実行後の応答結果で得られる最後の項目のIDを指定します。「limit」と併せて使用します。 |
| name(Optional) | VM名 | query | VM名を指定します。 |
Response Code
Success
200
Example
Request
curl -i -X GET -H "Accept: application/json" -H "X-Auth-Token: トークンID" https://compute.tyo1.conoha.io/v2/テナントID/servers
Response
HTTP/1.1 200 OK
Date: Tue, 09 Dec 2014 03:03:08 GMT
Server: Apache
Content-Length: 691
Content-Type: application/json
{
"servers": [
{
"id": "e25b3611-96df-4514-a54b-7729aec48dc1",
"links": [
{
"href": "https://compute.tyo1.conoha.io/v2/1864e71d2deb46f6b47526b69c65a45d/servers/e25b3611-96df-4514-a54b-7729aec48dc1",
"rel": "self"
},
{
"href": "https://compute.tyo1.conoha.io/1864e71d2deb46f6b47526b69c65a45d/servers/e25b3611-96df-4514-a54b-7729aec48dc1",
"rel": "bookmark"
}
],
"name": "server1"
},
{
"id": "f41ff26a-06c3-4470-9ed9-f20b6780f98d",
"links": [
{
"href": "https://compute.tyo1.conoha.io/v2/1864e71d2deb46f6b47526b69c65a45d/servers/f41ff26a-06c3-4470-9ed9-f20b6780f98d",
"rel": "self"
},
{
"href": "https://compute.tyo1.conoha.io/1864e71d2deb46f6b47526b69c65a45d/servers/f41ff26a-06c3-4470-9ed9-f20b6780f98d",
"rel": "bookmark"
}
],
"name": "server2"
},
{
"id": "efbc4dea-e7e3-4890-883c-9a7a5ca9e105",
"links": [
{
"href": "https://compute.tyo1.conoha.io/v2/1864e71d2deb46f6b47526b69c65a45d/servers/efbc4dea-e7e3-4890-883c-9a7a5ca9e105",
"rel": "self"
},
{
"href": "https://compute.tyo1.conoha.io/1864e71d2deb46f6b47526b69c65a45d/servers/efbc4dea-e7e3-4890-883c-9a7a5ca9e105",
"rel": "bookmark"
}
],
"name": "server3"
},
{
"id": "6d9e8d64-236d-4057-a899-f4cf797405cf",
"links": [
{
"href": "https://compute.tyo1.conoha.io/v2/1864e71d2deb46f6b47526b69c65a45d/servers/6d9e8d64-236d-4057-a899-f4cf797405cf",
"rel": "self"
},
{
"href": "https://compute.tyo1.conoha.io/1864e71d2deb46f6b47526b69c65a45d/servers/6d9e8d64-236d-4057-a899-f4cf797405cf",
"rel": "bookmark"
}
],
"name": "server4"
}
]
}
ConoHaにて提供しておりますAPIにつきましては、クラウド基盤として採用しておりますOpenStackの機能にて実装しておりますので、詳細な情報や使い方はOpenStackのドキュメントにてご確認ください。
