Description

作成済みVMの詳細情報を一覧で取得します。

Request URL

Compute API

GET /v2/{tenant_id}/servers/detail

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名を指定します。
status
(Optional)
VMのステータス query VMのステータスを指定します。
flavor
(Optional)
フレーバーID query VMで使用されているフレーバーIDを指定します。
image
(Optional)
イメージID query VMで使用されているイメージIDを指定します。
changes-since
(Optional)
ISO 8601 dateTime query 日時を指定します。削除されたものを含む、指定時間からのVM一覧を表示させたい場合に使用します。
例 2016-04-04T17:08Z

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/detail

Response

HTTP/1.1 200 OK
Date: Tue, 09 Dec 2014 03:09:33 GMT
Server: Apache
Content-Length: 3303
Content-Type: application/json

{
    "servers": [
        {
            "OS-DCF:diskConfig": "MANUAL",
            "OS-EXT-AZ:availability_zone": "nova",
            "OS-EXT-SRV-ATTR:host": "cn-a11019.g1.tyo1.v4",
            "OS-EXT-SRV-ATTR:hypervisor_hostname": "cn-a11019.g1.tyo1.v4",
            "OS-EXT-SRV-ATTR:instance_name": "tyo1-000024e6",
            "OS-EXT-STS:power_state": 4,
            "OS-EXT-STS:task_state": null,
            "OS-EXT-STS:vm_state": "stopped",
            "OS-SRV-USG:launched_at": "2015-05-08T01:00:46.000000",
            "OS-SRV-USG:terminated_at": null,
            "accessIPv4": "",
            "accessIPv6": "",
            "addresses": {
                "ext-133-130-48-xx-xx": [
                    {
                        "OS-EXT-IPS-MAC:mac_addr": "02:01:85:82:xx:xx",
                        "OS-EXT-IPS:type": "fixed",
                        "addr": "133.130.49.xxx",
                        "version": 4
                    },
                    {
                        "OS-EXT-IPS-MAC:mac_addr": "02:01:85:82:xx:xx",
                        "OS-EXT-IPS:type": "fixed",
                        "addr": "2400:8500:1301:727:133:130:49:xxxx",
                        "version": 6
                    }
                ]
            },
            "config_drive": "True",
            "created": "2015-05-08T01:00:41Z",
            "flavor": {
                "id": "7eea7469-0d85-4f82-8050-6ae742394681",
                "links": [
                    {
                        "href": "https://compute.tyo1.conoha.io/1864e71d2deb46f6b47526b69c65a45d/flavors/7eea7469-0d85-4f82-8050-6ae742394681",
                        "rel": "bookmark"
                    }
                ]
            },
            "hostId": "1b21cb1fa28badef69e02b6a2e71909dbf62a982e65892fad8ad01cf",
            "id": "e25b3611-96df-4514-a54b-7729aec48dc1",
            "image": {
                "id": "e2b62c96-abbc-41ae-a5f2-b0fe514b755c",
                "links": [
                    {
                        "href": "https://compute.tyo1.conoha.io/1864e71d2deb46f6b47526b69c65a45d/images/e2b62c96-abbc-41ae-a5f2-b0fe514b755c",
                        "rel": "bookmark"
                    }
                ]
            },
            "key_name": null,
            "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"
                }
            ],
            "metadata": {
                "backup_id": "",
                "backup_set": "0",
                "backup_status": "active",
                "instance_name_tag": "vps-2015-05-08-09-59",
                "properties": "{\"vnc_keymap\":\"ja\",\"hw_video_model\":\"vga\",\"hw_vif_model\":\"virtio\",\"hw_disk_bus\":\"virtio\",\"cdrom_path\":\"\"}"
            },
            "name": "server1",
            "os-extended-volumes:volumes_attached": [],
            "security_groups": [
                {
                    "name": "gncs-ipv4-ssh"
                },
                {
                    "name": "gncs-ipv6-ssh"
                }
            ],
            "status": "SHUTOFF",
            "tenant_id": "1864e71d2deb46f6b47526b69c65a45d",
            "updated": "2015-05-08T01:02:54Z",
            "user_id": "068ae7141b3a4e15bebb8b9ca177e9d3"
        },
        {
            "OS-DCF:diskConfig": "MANUAL",
            "OS-EXT-AZ:availability_zone": "nova",
            "OS-EXT-SRV-ATTR:host": "cn-a11023.g1.tyo1.v4",
            "OS-EXT-SRV-ATTR:hypervisor_hostname": "cn-a11023.g1.tyo1.v4",
            "OS-EXT-SRV-ATTR:instance_name": "tyo1-000024cc",
            "OS-EXT-STS:power_state": 1,
            "OS-EXT-STS:task_state": null,
            "OS-EXT-STS:vm_state": "active",
            "OS-SRV-USG:launched_at": "2015-05-07T10:41:27.000000",
            "OS-SRV-USG:terminated_at": null,
            "accessIPv4": "",
            "accessIPv6": "",
            "addresses": {
                "ext-157-7-108-0-xxx": [
                    {
                        "OS-EXT-IPS-MAC:mac_addr": "02:01:9d:07:xx:xx",
                        "OS-EXT-IPS:type": "fixed",
                        "addr": "2400:8500:1301:704:157:7:108:xxxx",
                        "version": 6
                    },
                    {
                        "OS-EXT-IPS-MAC:mac_addr": "02:01:9d:07:xx:xx",
                        "OS-EXT-IPS:type": "fixed",
                        "addr": "157.7.108.xxx",
                        "version": 4
                    }
                ]
            },
            "config_drive": "True",
            "created": "2015-05-07T10:41:23Z",
            "flavor": {
                "id": "7eea7469-0d85-4f82-8050-6ae742394681",
                "links": [
                    {
                        "href": "https://compute.tyo1.conoha.io/1864e71d2deb46f6b47526b69c65a45d/flavors/7eea7469-0d85-4f82-8050-6ae742394681",
                        "rel": "bookmark"
                    }
                ]
            },
            "hostId": "ce2fb61203aa223c6084b69842513ace1a197b8d727640ad05df5081",
            "id": "f41ff26a-06c3-4470-9ed9-f20b6780f98d",
            "image": {
                "id": "e2b62c96-abbc-41ae-a5f2-b0fe514b755c",
                "links": [
                    {
                        "href": "https://compute.tyo1.conoha.io/1864e71d2deb46f6b47526b69c65a45d/images/e2b62c96-abbc-41ae-a5f2-b0fe514b755c",
                        "rel": "bookmark"
                    }
                ]
            },
            "key_name": null,
            "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"
                }
            ],
            "metadata": {
                "backup_id": "",
                "backup_set": "0",
                "backup_status": "active",
                "instance_name_tag": "vps-2015-05-07-19-41",
                "properties": "{\"vnc_keymap\":\"ja\",\"hw_video_model\":\"vga\",\"hw_vif_model\":\"virtio\",\"hw_disk_bus\":\"virtio\",\"cdrom_path\":\"\"}"
            },
            "name": "server2",
            "os-extended-volumes:volumes_attached": [],
            "progress": 0,
            "security_groups": [
                {
                    "name": "gncs-ipv4-ssh"
                },
                {
                    "name": "gncs-ipv6-ssh"
                }
            ],
            "status": "ACTIVE",
            "tenant_id": "1864e71d2deb46f6b47526b69c65a45d",
            "updated": "2015-05-07T10:41:27Z",
            "user_id": "068ae7141b3a4e15bebb8b9ca177e9d3"
        },
        {
            "OS-DCF:diskConfig": "MANUAL",
            "OS-EXT-AZ:availability_zone": "nova",
            "OS-EXT-SRV-ATTR:host": "cn-a11021.g1.tyo1.v4",
            "OS-EXT-SRV-ATTR:hypervisor_hostname": "cn-a11021.g1.tyo1.v4",
            "OS-EXT-SRV-ATTR:instance_name": "tyo1-000024c6",
            "OS-EXT-STS:power_state": 4,
            "OS-EXT-STS:task_state": null,
            "OS-EXT-STS:vm_state": "stopped",
            "OS-SRV-USG:launched_at": "2015-05-07T10:28:10.000000",
            "OS-SRV-USG:terminated_at": null,
            "accessIPv4": "",
            "accessIPv6": "",
            "addresses": {
                "ext-133-130-48-xxx-xxx": [
                    {
                        "OS-EXT-IPS-MAC:mac_addr": "02:01:85:82:xx:xx",
                        "OS-EXT-IPS:type": "fixed",
                        "addr": "133.130.48.xxx",
                        "version": 4
                    },
                    {
                        "OS-EXT-IPS-MAC:mac_addr": "02:01:85:82:xx:xx",
                        "OS-EXT-IPS:type": "fixed",
                        "addr": "2400:8500:1301:727:133:130:48:xxxx",
                        "version": 6
                    }
                ]
            },
            "config_drive": "True",
            "created": "2015-05-07T10:28:03Z",
            "flavor": {
                "id": "7eea7469-0d85-4f82-8050-6ae742394681",
                "links": [
                    {
                        "href": "https://compute.tyo1.conoha.io/1864e71d2deb46f6b47526b69c65a45d/flavors/7eea7469-0d85-4f82-8050-6ae742394681",
                        "rel": "bookmark"
                    }
                ]
            },
            "hostId": "2aee104cc649e7f7c60206adfd156be57e42e8fb4ecba1fa46931d13",
            "id": "efbc4dea-e7e3-4890-883c-9a7a5ca9e105",
            "image": {
                "id": "e2b62c96-abbc-41ae-a5f2-b0fe514b755c",
                "links": [
                    {
                        "href": "https://compute.tyo1.conoha.io/1864e71d2deb46f6b47526b69c65a45d/images/e2b62c96-abbc-41ae-a5f2-b0fe514b755c",
                        "rel": "bookmark"
                    }
                ]
            },
            "key_name": null,
            "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"
                }
            ],
            "metadata": {
                "backup_id": "",
                "backup_set": "0",
                "backup_status": "active",
                "instance_name_tag": "vps-2015-05-07-19-27",
                "properties": "{\"vnc_keymap\":\"ja\",\"hw_video_model\":\"vga\",\"hw_vif_model\":\"virtio\",\"hw_disk_bus\":\"virtio\",\"cdrom_path\":\"\"}"
            },
            "name": "server3",
            "os-extended-volumes:volumes_attached": [
                {
                    "id": "a86e6a45-1c8b-4ae5-9411-a796220b719b"
                }
            ],
            "security_groups": [
                {
                    "name": "gncs-ipv4-ssh"
                },
                {
                    "name": "gncs-ipv6-ssh"
                }
            ],
            "status": "SHUTOFF",
            "tenant_id": "1864e71d2deb46f6b47526b69c65a45d",
            "updated": "2015-05-07T10:43:36Z",
            "user_id": "068ae7141b3a4e15bebb8b9ca177e9d3"
        },
        {
            "OS-DCF:diskConfig": "MANUAL",
            "OS-EXT-AZ:availability_zone": "nova",
            "OS-EXT-SRV-ATTR:host": "cn-a11022.g2.tyo1.v4",
            "OS-EXT-SRV-ATTR:hypervisor_hostname": "cn-a11022.g2.tyo1.v4",
            "OS-EXT-SRV-ATTR:instance_name": "tyo1-000024b2",
            "OS-EXT-STS:power_state": 4,
            "OS-EXT-STS:task_state": null,
            "OS-EXT-STS:vm_state": "stopped",
            "OS-SRV-USG:launched_at": "2015-05-07T09:23:03.000000",
            "OS-SRV-USG:terminated_at": null,
            "accessIPv4": "",
            "accessIPv6": "",
            "addresses": {
                "ext-133-130-48-xxx-xx": [
                    {
                        "OS-EXT-IPS-MAC:mac_addr": "02:01:85:82:xx:xx",
                        "OS-EXT-IPS:type": "fixed",
                        "addr": "133.130.49.xxx",
                        "version": 4
                    },
                    {
                        "OS-EXT-IPS-MAC:mac_addr": "02:01:85:82:xx:xx",
                        "OS-EXT-IPS:type": "fixed",
                        "addr": "2400:8500:1301:727:133:130:49:xxxx",
                        "version": 6
                    }
                ]
            },
            "config_drive": "True",
            "created": "2015-05-07T09:22:57Z",
            "flavor": {
                "id": "7eea7469-0d85-4f82-8050-6ae742394681",
                "links": [
                    {
                        "href": "https://compute.tyo1.conoha.io/1864e71d2deb46f6b47526b69c65a45d/flavors/7eea7469-0d85-4f82-8050-6ae742394681",
                        "rel": "bookmark"
                    }
                ]
            },
            "hostId": "fa6657fcc777a69cf26009030762961bbeb41d2cd02074b651b1e6f6",
            "id": "6d9e8d64-236d-4057-a899-f4cf797405cf",
            "image": {
                "id": "e2b62c96-abbc-41ae-a5f2-b0fe514b755c",
                "links": [
                    {
                        "href": "https://compute.tyo1.conoha.io/1864e71d2deb46f6b47526b69c65a45d/images/e2b62c96-abbc-41ae-a5f2-b0fe514b755c",
                        "rel": "bookmark"
                    }
                ]
            },
            "key_name": null,
            "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"
                }
            ],
            "metadata": {
                "backup_id": "",
                "backup_set": "0",
                "backup_status": "active",
                "instance_name_tag": "vps-2015-05-07-18-22",
                "properties": "{\"vnc_keymap\":\"ja\",\"hw_video_model\":\"vga\",\"hw_vif_model\":\"virtio\",\"hw_disk_bus\":\"virtio\",\"cdrom_path\":\"\"}"
            },
            "name": "server4",
            "os-extended-volumes:volumes_attached": [
                {
                    "id": "997d6052-4b17-4500-8d41-c08fb9667aae"
                }
            ],
            "security_groups": [
                {
                    "name": "gncs-ipv4-ssh"
                },
                {
                    "name": "gncs-ipv6-ssh"
                }
            ],
            "status": "SHUTOFF",
            "tenant_id": "1864e71d2deb46f6b47526b69c65a45d",
            "updated": "2015-05-07T10:43:29Z",
            "user_id": "068ae7141b3a4e15bebb8b9ca177e9d3"
        }
    ]
}

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