How to create a Virtual Machine with a local boot disk (Local)?

To create a Virtual Machine (VM) with a local boot disk (Local), specify the `"imageRef"` parameter in the API request.

In the example below, a VM is created with a new local boot disk from the pre-installed image 754e77f5-9a0c-4549-b49d-7bde34dc960f (Ubuntu 18.04.4 CUDA).

{
"server" : {
"name": "local",
"imageRef": "754e77f5-9a0c-4549-b49d-7bde34dc960f",
"flavorRef": "8f9a148d-b258-42f7-bcc2-32581d86e1f1",
"availability_zone": "nova",
"networks": [{ "uuid": "cc5f6f4a-2c44-44a4-af9a-f8534e34d2b7" }],
"key_name": "my_keypair",
"max_count": 1,
"min_count": 1
}
}

Where:

  • "name": "local" — the name of the new VM;
  • "imageRef": "754e77f5-9a0c-4549-b49d-7bde34dc960f" — OpenStack ID of the OS image;
  • "flavorRef": "8f9a148d-b258-42f7-bcc2-32581d86e1f1" — OpenStack ID of the configuration;
  • "networks": [{ "uuid": "cc5f6f4a-2c44-44a4-af9a-f8534e34d2b7" }] — OpenStack ID of the network in which the VM will receive an IP-address;
  • "key_name": "my_keypair" — the name of your Key Pair.

When this Virtual Machine is deleted, its boot disk is also permanently removed.

Updated Date 28.11.2025