ログイン

イメージ一覧取得

Description

イメージの一覧を取得します。

Request URL

Image API

GET /v2/images

Request Json

This operation does not accept a request body.

Request Parameters

Parameter Value Style Description
X-Auth-Token トークンID header トークンIDを指定します。
visibility
(Optional)		 public
private		 query イメージの公開状態の属性を指定します。
標準で用意されているイメージでフィルターをかける場合は、「public」を指定します。お客様独自で保存もしくは作成されたイメージでフィルターをかける場合は、「private」を指定します。
sort_key
(Optional)		 項目 query ソート対象の項目を指定します。
デフォルトの項目は「created_at」です。
sort_dir
(Optional)		 asc
desc		 query ソート対象の並び順を指定します。
並び順は、「asc(昇順) 」または「desc(降順)」が指定できます。デフォルトの項目は「desc」です。
name
(Optional)		 イメージ名 query イメージ名を指定します。
status
(Optional)		 イメージのステータス query イメージのステータスを指定します。
size_min
(Optional)		 バイト数 query イメージの最小サイズ(バイト数)を指定します。
size_max
(Optional)		 バイト数 query イメージの最大サイズ(バイト数)を指定します。
owner
(Optional)		 テナントID query 表示させたいイメージを所有しているテナントIDを指定します。
tag
(Optional)		 タグ query イメージのタグを指定します。

Response Code

Success 

200

Example

Request 

curl -i -X GET \
-H "Accept: application/json" \
-H "X-Auth-Token: トークンID" \
https://image-service.tyo1.conoha.io/v2/images

Response 

HTTP/1.1 200 OK
Date: Tue, 09 Dec 2014 10:17:20 GMT
Server: Apache
Content-Length: 6102
Content-Type: application/json

{
  "images": [
    {
      "status": "active",
      "name": "testsnap",
      "tags": [],
      "container_format": "ovf",
      "created_at": "2014-12-05T13:16:57Z",
      "size": 3134390272,
      "disk_format": "qcow2",
      "updated_at": "2014-12-05T13:17:14Z",
      "visibility": "private",
      "id": "e9a36da8-5c2e-4d8c-a7a4-db32e7054d34",
      "self": "/v2/images/e9a36da8-5c2e-4d8c-a7a4-db32e7054d34",
      "min_disk": 0,
      "protected": false,
      "min_ram": 0,
      "file": "/v2/images/e9a36da8-5c2e-4d8c-a7a4-db32e7054d34/file",
      "checksum": "238c596d2aa5c4c1daa101c4eb3682ff",
      "owner": "65a85d8e02e7470da8f72ed31effaf4e",
      "direct_url": "file:///var/lib/glance/images/e9a36da8-5c2e-4d8c-a7a4-db32e7054d34",
      "hw_qemu_guest_agent": "yes",
      "schema": "/v2/schemas/image"
    },
    {
      "status": "active",
      "name": "okvm-centos65_ga_fio",
      "tags": [],
      "container_format": "ovf",
      "created_at": "2014-12-05T13:09:24Z",
      "size": 3135963136,
      "disk_format": "qcow2",
      "updated_at": "2014-12-05T13:09:41Z",
      "visibility": "private",
      "id": "7e8ef227-9000-46f2-82b4-c7d68f1bcf96",
      "self": "/v2/images/7e8ef227-9000-46f2-82b4-c7d68f1bcf96",
      "min_disk": 0,
      "protected": false,
      "min_ram": 0,
      "file": "/v2/images/7e8ef227-9000-46f2-82b4-c7d68f1bcf96/file",
      "checksum": "5331449d33377d47459628542f542d4d",
      "owner": "65a85d8e02e7470da8f72ed31effaf4e",
      "direct_url": "file:///var/lib/glance/images/7e8ef227-9000-46f2-82b4-c7d68f1bcf96",
      "hw_qemu_guest_agent": "yes",
      "schema": "/v2/schemas/image"
    },
    {
      "status": "active",
      "name": "okvm-centos65",
      "tags": [],
      "container_format": "ovf",
      "created_at": "2014-12-05T12:33:00Z",
      "size": 2967273472,
      "disk_format": "qcow2",
      "updated_at": "2014-12-05T12:33:18Z",
      "visibility": "private",
      "self": "/v2/images/7b85762c-23d0-4ed0-805b-b5a0604049a2",
      "min_disk": 0,
      "protected": false,
      "id": "7b85762c-23d0-4ed0-805b-b5a0604049a2",
      "file": "/v2/images/7b85762c-23d0-4ed0-805b-b5a0604049a2/file",
      "checksum": "765f4a4670240bcd1e7f40fe5e655c90",
      "owner": "4a9f0a43587e46258d6b0feb45b58b31",
      "direct_url": "file:///var/lib/glance/images/7b85762c-23d0-4ed0-805b-b5a0604049a2",
      "min_ram": 0,
      "schema": "/v2/schemas/image"
    },
    {
      "status": "active",
      "name": "okvm-centos65_ga",
      "tags": [],
      "container_format": "ovf",
      "created_at": "2014-12-05T12:32:10Z",
      "size": 2967273472,
      "disk_format": "qcow2",
      "updated_at": "2014-12-05T12:32:26Z",
      "visibility": "public",
      "id": "0481cc6f-5cee-474c-bdf3-b46c793a94ec",
      "self": "/v2/images/0481cc6f-5cee-474c-bdf3-b46c793a94ec",
      "min_disk": 0,
      "protected": false,
      "min_ram": 0,
      "file": "/v2/images/0481cc6f-5cee-474c-bdf3-b46c793a94ec/file",
      "checksum": "5ada4a66c2598d39fb6aacc6731aeae4",
      "owner": "4a9f0a43587e46258d6b0feb45b58b31",
      "direct_url": "file:///var/lib/glance/images/0481cc6f-5cee-474c-bdf3-b46c793a94ec",
      "hw_qemu_guest_agent": "yes",
      "schema": "/v2/schemas/image"
    },
    {
      "status": "active",
      "name": "okvm-centos65",
      "tags": [],
      "container_format": "ovf",
      "created_at": "2014-12-03T08:22:44Z",
      "size": 2967273472,
      "disk_format": "qcow2",
      "updated_at": "2014-12-03T08:23:02Z",
      "visibility": "public",
      "self": "/v2/images/765acb4f-e4df-4f9f-a37c-e062df376504",
      "protected": false,
      "id": "765acb4f-e4df-4f9f-a37c-e062df376504",
      "file": "/v2/images/765acb4f-e4df-4f9f-a37c-e062df376504/file",
      "checksum": "765f4a4670240bcd1e7f40fe5e655c90",
      "min_disk": 0,
      "direct_url": "file:///var/lib/glance/images/765acb4f-e4df-4f9f-a37c-e062df376504",
      "min_ram": 0,
      "schema": "/v2/schemas/image"
    },
    {
      "status": "active",
      "name": "cirros-0.3.3-x86_64",
      "tags": [],
      "container_format": "bare",
      "created_at": "2014-12-03T07:48:41Z",
      "size": 13200896,
      "disk_format": "qcow2",
      "updated_at": "2014-12-03T07:48:42Z",
      "visibility": "public",
      "self": "/v2/images/3cab9d0f-29b1-45e3-b5fd-76e8d746b289",
      "protected": false,
      "id": "3cab9d0f-29b1-45e3-b5fd-76e8d746b289",
      "file": "/v2/images/3cab9d0f-29b1-45e3-b5fd-76e8d746b289/file",
      "checksum": "133eae9fb1c98f45894a4e60d8736619",
      "min_disk": 0,
      "direct_url": "file:///var/lib/glance/images/3cab9d0f-29b1-45e3-b5fd-76e8d746b289",
      "min_ram": 0,
      "schema": "/v2/schemas/image"
    },
    {
      "status": "active",
      "name": "cirros-0.3.3-x86_64",
      "tags": [],
      "container_format": "bare",
      "created_at": "2014-12-03T07:48:38Z",
      "size": 13200896,
      "disk_format": "qcow2",
      "updated_at": "2014-12-03T07:48:39Z",
      "visibility": "public",
      "self": "/v2/images/fd2cbdb5-b4dd-4afe-8409-fb2998ca50ef",
      "protected": false,
      "id": "fd2cbdb5-b4dd-4afe-8409-fb2998ca50ef",
      "file": "/v2/images/fd2cbdb5-b4dd-4afe-8409-fb2998ca50ef/file",
      "checksum": "133eae9fb1c98f45894a4e60d8736619",
      "min_disk": 0,
      "direct_url": "file:///var/lib/glance/images/fd2cbdb5-b4dd-4afe-8409-fb2998ca50ef",
      "min_ram": 0,
      "schema": "/v2/schemas/image"
    },
    {
      "status": "active",
      "name": "cirros-0.3.3-x86_64",
      "tags": [],
      "container_format": "bare",
      "created_at": "2014-12-03T07:42:58Z",
      "size": 13200896,
      "disk_format": "qcow2",
      "updated_at": "2014-12-03T07:42:59Z",
      "visibility": "public",
      "self": "/v2/images/a6f3a56f-0e21-4dfc-b267-9df611034a5d",
      "protected": false,
      "id": "a6f3a56f-0e21-4dfc-b267-9df611034a5d",
      "file": "/v2/images/a6f3a56f-0e21-4dfc-b267-9df611034a5d/file",
      "checksum": "133eae9fb1c98f45894a4e60d8736619",
      "min_disk": 0,
      "direct_url": "file:///var/lib/glance/images/a6f3a56f-0e21-4dfc-b267-9df611034a5d",
      "min_ram": 0,
      "schema": "/v2/schemas/image"
    },
    {
      "status": "active",
      "name": "cirros-0.3.3-x86_64",
      "tags": [],
      "container_format": "bare",
      "created_at": "2014-12-03T07:41:52Z",
      "size": 13200896,
      "disk_format": "qcow2",
      "updated_at": "2014-12-03T07:41:52Z",
      "visibility": "public",
      "self": "/v2/images/62094b84-d4fb-4066-b308-1d54790e5421",
      "protected": false,
      "id": "62094b84-d4fb-4066-b308-1d54790e5421",
      "file": "/v2/images/62094b84-d4fb-4066-b308-1d54790e5421/file",
      "checksum": "133eae9fb1c98f45894a4e60d8736619",
      "min_disk": 0,
      "direct_url": "file:///var/lib/glance/images/62094b84-d4fb-4066-b308-1d54790e5421",
      "min_ram": 0,
      "schema": "/v2/schemas/image"
    },
    {
      "status": "active",
      "name": "cirros-0.3.3-x86_64",
      "tags": [],
      "container_format": "bare",
      "created_at": "2014-12-03T07:41:38Z",
      "size": 13200896,
      "disk_format": "qcow2",
      "updated_at": "2014-12-03T07:41:38Z",
      "visibility": "public",
      "self": "/v2/images/ac394825-792b-4a8d-8a46-6cf18b0ef660",
      "protected": false,
      "id": "ac394825-792b-4a8d-8a46-6cf18b0ef660",
      "file": "/v2/images/ac394825-792b-4a8d-8a46-6cf18b0ef660/file",
      "checksum": "133eae9fb1c98f45894a4e60d8736619",
      "min_disk": 0,
      "direct_url": "file:///var/lib/glance/images/ac394825-792b-4a8d-8a46-6cf18b0ef660",
      "min_ram": 0,
      "schema": "/v2/schemas/image"
    }
  ],
  "schema": "/v2/schemas/images",
  "first": "/v2/images"
}

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