Description
ボリュームを作成します。
Request URL
Volume API
POST /v2/{tenant_id}/volumes
Request Json
・新規作成の場合
{
"volume": {
"size": サイズ,
"name": "ボリューム名",
"metadata": {}
}
}
・各種ソース
{
"volume": {
"source_volid": "複製元のボリュームID",
"description": "概要",
"snapshot_id": null,
"size": サイズ,
"name": "ボリューム名",
"imageRef": "イメージID",
"metadata": {}
}
}
Request Parameters
| Parameter | Value | Style | Description |
|---|---|---|---|
| X-Auth-Token | トークンID | header | トークンIDを指定します。 |
| Content-Type | application/json | header | データの形式(メディアタイプ)を指定します。 |
| tenant_id | テナントID | path | テナントIDを指定します。 |
| size | 200500 | body | 任意のボリューム容量を指定します。 |
| name | ボリューム名 | body | 任意のボリュームの名前を指定します。使用可能な文字列は、半角英数字、「-(ハイフン)」、「_(アンダーバー)」のみ。文字数の上限は、255文字になります。 |
| description(Optional) | 概要 | body | 任意の概要(説明)を指定します。 |
| imageRef(Optional) | イメージID | body | イメージIDを指定します。保存したイメージから作成したい場合に使用します。 |
| source_volid(Optional) | ボリュームID | body | 複製元のボリュームIDを指定します。既存のボリュームから複製したい場合に使用します。 |
| metadata(Optional) | メタデータ | body | ボリュームのメタデータを指定します。 |
Response Code
Success
202
Example
Request
curl -i -X POST -H "Accept: application/json" -H "Content-Type: application/json" -H "X-Auth-Token: トークンID" -d '{"volume":{"size":サイズ,"name":"ボリューム名", "metadata":{}}}' https://block-storage.tyo1.conoha.io/v2/テナントID/volumes
Response
HTTP/1.1 202 Accepted
Date: Thu, 11 Dec 2014 11:17:52 GMT
Server: Apache
Content-Length: 820
Content-Type: application/json
{
"volume": {
"attachments": [],
"availability_zone": "nova",
"bootable": "false",
"consistencygroup_id": null,
"created_at": "2015-05-08T09:17:04.365238",
"description": null,
"encrypted": false,
"id": "40e84769-f99a-4d7f-8594-4d0db87bc7e4",
"links": [
{
"href": "https://block-storage.tyo1.conoha.io/v2/1864e71d2deb46f6b47526b69c65a45d/volumes/40e84769-f99a-4d7f-8594-4d0db87bc7e4",
"rel": "self"
},
{
"href": "https://block-storage.tyo1.conoha.io/1864e71d2deb46f6b47526b69c65a45d/volumes/40e84769-f99a-4d7f-8594-4d0db87bc7e4",
"rel": "bookmark"
}
],
"metadata": {},
"name": "gmo-vol",
"replication_status": "disabled",
"size": 200,
"snapshot_id": null,
"source_volid": null,
"status": "creating",
"user_id": "ea63fc7a16bb4250aff7e203198eea22",
"volume_type": "SAMPLE_VOLUME_TYPE"
}
}
ConoHaにて提供しておりますAPIにつきましては、クラウド基盤として採用しておりますOpenStackの機能にて実装しておりますので、詳細な情報や使い方はOpenStackのドキュメントにてご確認ください。
