ログイン

VM一覧取得

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のドキュメントにてご確認ください。