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 29.12.2025
We use cookies and web analytics services to ensure the proper functioning of the website, analyze web-site traffic, and improve the quality of our services.
By continuing to use the website, you consent to the Privacy Policy and consent to the processing of cookie files and technical data.