ユーザーガイド/リファレンスガイド

Block Storage API v2

Description

tenant_id を指定し詳細なボリューム一覧を取得します。

Request URL

Block Storage API v2

GET /v2/{tenant_id}/volumes/detail

Request Json

This operation does not accept a request body.

Request Paramters

Parameter Value Style Description
X-Auth-Token Userトークン header トークンID
tenant_id Tenant ID URI テナントID

Response

Normal response codes

200

Example

Request

curl -i -X GET \
-H “Accept: application/json” \
-H “Content-Type: application/json” \
-H “X-Auth-Token: トークンID” \
https://block-storage.odc01.eva-clouds.com/v2/テナントID/volumes/detail

Response

HTTP/1.1 200 OK
Date: Thu, 07 Jul 2016 08:50:19 GMT
Server: Apache
Content-Type: application/json

{
 ”volumes”: [
  {
   ”attachments”: [
    {
     ”host_name”: null,
     ”device”: “/dev/vda”,
     ”server_id”: “サーバーID“,
     ”id”: “ボリュームID“,
     ”volume_id”: “ボリュームID
    }
   ],
   ”links”: [
    {
     ”href”: “https://block-storage.odc01.eva-clouds.com/v2/テナントID/volumes/ボリュームID“,
     ”rel”: “self”
    },
    {
     ”href”: “https://block-storage.odc01.eva-clouds.com/テナントID/volumes/ボリュームID“,
     ”rel”: “bookmark”
    }
   ],
   ”availability_zone”: “nova”,
   ”encrypted”: false,
   ”os-volume-replication:extended_status”: null,
   ”volume_type”: “ボリュームタイプ名“,
   ”snapshot_id”: null,
   ”id”: “ボリュームID“,
   ”size”: ボリュームサイズ,
   ”user_id”: “fe9256e97cbc4b2c8c68743e85311b84”,
   ”os-vol-tenant-attr:tenant_id”: “テナントID“,
   ”metadata”: {
    ”readonly”: “False”,
    ”attached_mode”: “rw”
   },
   ”status”: “in-use”,
   ”volume_image_metadata”: {
    ”dst”: “CentOS-7.2-50GB-64bit”,
    ”bootable”: “true”,
    ”checksum”:     ”4b1a4890e3eee22e2a8e4f89c13a589c”,
    ”hw_qemu_guest_agent”: “yes”,
    ”disk_format”: “qcow2”,
    ”image_name”: “イメージ名“,
    ”image_id”: “イメージID“,
    ”min_ram”: “0”,
    ”container_format”: “ovf”,
    ”min_disk”: “50”,
    ”os_type”: “lin”,
    ”display_order”: “300”,
    ”size”: “2088435712”
   },
   ”description”: null,
   ”source_volid”: null,
   ”consistencygroup_id”: null,
   ”name”: “ボリューム名“,
   ”bootable”: “true”,
   ”created_at”: “2016-07-07T06:34:56.000000”,
   ”os-volume-replication:driver_data”: null,
   ”replication_status”: “disabled”
  }
 ] }

 

Description

tenant_id を指定しボリューム一覧を取得します。

Request URL

Block Storage API v2
GET /v2/{tenant_id}/volumes

Request Json

This operation does not accept a request body.

Request Paramters

Parameter Value Style Description
X-Auth-Token Userトークン header トークンID
tenant_id テナントID URI テナントID
limit (Optional)   query レスポンスアイテム数を制限します
marker (Optional)   query 表示される最後のUUID オフセットとして利用します
sort_key (Optional)   query ソートキーを指定する デフォルトは’created_at’です
sort_dir (Optional)   query ソート方向を指定する デフォルトは’desc’です

Response

Normal response codes

200

Example

Request

curl -i -X GET \
-H “Accept: application/json” \
-H “Content-Type: application/json” \
-H “X-Auth-Token: トークンID” \
https://block-storage.odc01.eva-clouds.com/v2/テナントID/volumes

Response

HTTP/1.1 200 OK
Date: Thu, 07 Jul 2016 08:45:15 GMT
Server: Apache
Content-Length: 3022
Content-Type: application/json

{
    “volumes”: [
        {
            “id”: “ボリュームID“,
            “links”: [
                {
                    “href”: “https://block-storage.odc01.eva-clouds.com/v2/テナントID/volumes/ボリュームID“,
                    “rel”: “self”
                },
                {
                    “href”: “https://block-storage.odc01.eva-clouds.com/テナントID/volumes/ボリュームID“,
                    “rel”: “bookmark”
                }
            ],
            “name”: “ボリューム名
        },
        {
            “id”: “ボリュームID“,
            “links”: [
                {
                    “href”: “https://block-storage.odc01.eva-clouds.com/v2/テナントID/volumes/ボリュームID“,
                    “rel”: “self”
                },
                {
                    “href”: “https://block-storage.odc01.eva-clouds.com/テナントID/volumes/ボリュームID“,
                    “rel”: “bookmark”
                }
            ],
            “name”: “ボリューム名
        }
    ] }

 

Description

tenant_id,volume_type_idを指定しボリュームタイプの情報を取得します。

Request URL

Block Storage API v2
GET /v2/{tenant_id}/types/{volume_type_id}

Request Json

This operation does not accept a request body.

Request Paramters

Parameter Value Style Description
X-Auth-Token Userトークン header トークンID
tenant_id テナントID URI テナントID
volume_type_id ボリュームタイプID URI ボリュームタイプID

Response

Normal response codes

200

Example

Request

curl -i -X GET \
-H “Accept: application/json” \
-H “Content-Type: application/json” \
-H “X-Auth-Token: トークンID” \
https://block-storage.odc01.eva-clouds.com/v2/テナントID/types/ボリュームタイプID

Response

HTTP/1.1 200 OK
Date: Wed, 06 Jul 2016 05:56:57 GMT
Server: Apache
Content-Length: 142
Content-Type: application/json

{
    “volume_type”: {
        “extra_specs”: {
            “volume_backend_name”: “unifyd_vol0”
        },
         “id”: “ボリュームタイプID“,
         “name”: “ボリュームタイプ名
    }
}

 

Description

tenant_idを指定しボリュームタイプ一覧を取得します。

Request URL

Block Storage API v2
GET /v2/{tenant_id}/types

Request Json

This operation does not accept a request body.

Request Paramters

Parameter Value Style Description
X-Auth-Token Userトークン header トークンID
tenant_id テナントID URI テナントID

Response

Normal response codes

200

Example

Request

curl -i -X GET \
-H “Accept: application/json” \
-H “Content-Type: application/json” \
-H “X-Auth-Token: トークンID” \
https://block-storage.odc01.eva-clouds.com/v2/テナントID/types

Response

HTTP/1.1 200 OK
Date: Wed, 06 Jul 2016 05:44:15 GMT
Server: Apache
Content-Length: 524
Content-Type: application/json

{
    “volume_types”: [
        {
            “extra_specs”: {
                “volume_backend_name”: “unifyd_vol0”
            },
            “name”: “ボリュームタイプ名“,
            “id”: “ボリュームタイプID
        },
        {
            “extra_specs”: {
                “volume_backend_name”: “unifyd_vol0”
            },
            “name”: “ボリュームタイプ名“,
            “id”: “ボリュームタイプID
        },
        {
            “extra_specs”: {
                “volume_backend_name”: “unifyd_vol0”
            },
            “name”: “ボリュームタイプ名“,
            “id”: “ボリュームタイプID
        },
        {
            “extra_specs”: {
                “volume_backend_name”: “unifyd_vol0”
            },
            “name”: “ボリュームタイプ名“,
            “id”: “ボリュームタイプID
        }
    ] }

 

Description

バージョン情報を取得します。

Request URL

Block Storage API v2

GET /

Request Json

This operation does not accept a request body.

Request Paramters

This operation does not accept a request body.

Response

Normal response codes

300

Example

Request

curl -i -X GET \
-H “Accept: application/json” \
https://block-storage.odc01.eva-clouds.com

Response

HTTP/1.1 300 Multiple Choices
Date: Mon, 25 Jul 2016 06:15:14 GMT
Server: Apache
Content-Length: 164
Content-Type: application/json

{
 ”versions”: [
  {
   ”status”: “CURRENT”,
   ”updated”: “2016-08-15T09:00:00Z”,
   ”id”: “v2.0”,
   ”links”: [
    {
     ”href”: “https://block-storage.odc01.eva-clouds.com/v2/”,
     ”rel”: “self”
    }
   ]   }
 ] }

 

Description

バージョン情報詳細を取得します。

Request URL

Block Storage API v2

GET /v2

Request Json

This operation does not accept a request body.

Request Paramters

This operation does not accept a request body.

Response

Normal response codes

200

Example

Request

curl -i -X GET \
-H “Accept: application/json” \
-H “Content-Type: application/json” \
https://block-storage.odc01.eva-clouds.com/v2

Response

HTTP/1.1 200 OK
Date: Fri, 08 Jul 2016 09:14:56 GMT
Server: Apache
Content-Length: 309
Content-Type: application/json

{
 ”version”: {
 ”id”: “v2.0”,
 ”links”: [
  {
   ”href”: “https://block-storage.odc01.eva-clouds.com/v2/”,
   ”rel”: “self”
  },
  {
   ”href”: “https://s-port.eva-clouds.com/”,
   ”rel”: “describedby”,
   ”type”: “text/html”
  }
 ],
 ”media-types”: [
  {
   ”base”: “application/json”
  },
  {
   ”base”: “application/xml”
  }
 ],
 ”status”: “CURRENT”,
 ”updated”: “2016-08-15T09:00:00Z”
 }
}