ボリューム作成
Description
外部ディスクプランのブートディスク用 もしくは 追加ディスクとしてアタッチするブロックストレージ用のボリュームを作成します。
外部ディスクプランのブートディスクを作成する場合は、「imageRef」パラメーターの指定が必須です。
アタッチされていない50GB-500IOPSのブロックストレージ上限は、10個まで作成が可能です。
ボリューム名には半角英数字と-(ハイフン)の使用が可能です。
Request URL
Block Storage Service API v2
POST v2/{tenant_id}/volumes
Request Json
### ブートディスク用の場合 ###
{
"volume": {
"name": "ボリューム名",
"volume_type": "ボリュームタイプ名",
"size": "ボリューム容量",
"imageRef": "イメージID"
}
}
### 追加ディスク用の場合 ###
{
"volume": {
"name": "ボリューム名",
"volume_type": "ボリュームタイプ名",
"size": "ボリューム容量"
}
}
### ボリュームの複製の場合 ###
{
"volume": {
"name": "ボリューム名",
"volume_type": "ボリュームタイプ名",
"size": "ボリューム容量",
"source_volid": "複製元のボリュームID"
}
}
Request Parameters
| Parameter | Value | Style | Description |
|---|---|---|---|
| X-Auth-Token | トークンID | header | トークン発行 にて払い出されたID |
| tenant_id | テナントID | URI | コントロールパネルにてAPI情報をご確認ください。 |
| name | ボリューム名 | plain | 任意のボリューム名を指定します。 半角英数字と-(ハイフン)の使用が可能です。 |
| size | 50 100 200 300 400 500 1000 2000 | plain | 任意のディスク容量を指定します。 |
| volume_type | ボリュームタイプ名 | plain | ボリュームタイプ一覧取得 にて対象のボリュームタイプ名をご確認ください。 |
| imageRef(Optional) | イメージID | URI | イメージ一覧取得 にて対象のイメージIDをご確認ください。 |
| source_volid (Optional) | 複製元のボリュームID | URI | ボリューム詳細一覧取得 にて複製元のボリュームIDをご確認ください。サイズの変更はできません。 |
Response
-
Normal response codes
202
Example
-
Request ※ブートディスク用の場合
curl -X POST \ -H "Accept: application/json" \ -H "X-Auth-Token: トークンID" \ -d '{"volume": {"name": "ボリューム名","volume_type": "ボリュームタイプ名","size": "ボリューム容量","imageRef":"イメージID"}}' \ ボリュームエンドポイント/volumes
-
Response
{
"volume": {
"status": "creating",
"user_id": "ユーザーID",
"attachments": [],
"links": [
{
"href": "ボリュームエンドポイント/volumes/ボリュームID",
"rel": "self"
},
{
"href": "https://block-service-r4nd1001.app-sys.jp/テナントID/volumes/ボリュームID",
"rel": "bookmark"
}
],
"availability_zone": "nova",
"bootable": "false",
"encrypted": false,
"created_at": "2018-03-30T09:18:39.200116",
"description": null,
"volume_type": "ボリュームタイプ名",
"name": "ディスク名",
"replication_status": "disabled",
"consistencygroup_id": null,
"source_volid": null,
"snapshot_id": null,
"metadata": {},
"id": "ボリュームID",
"size": ボリューム容量
}
}