Creating and Deleting a VM

Create a VM via the API

Use the POST /v3/flexVM/clouds/{cloudUuid}/vms endpoint with a JSON body.

Example request:

POST /v3/flexVM/clouds/{cloudUuid}/vms
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json

{
  "description": "DB1 VM",
  "image_name": "ubuntu-2404-server-amd64",
  "instance_type_name": "vm.gpu.1rtx4000.30c.240g",
  "name": "development.ubuntu-2404",
  "ssh_keys": [
    "ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTuRa6Gtysdg2EF+SIXheVFVpHJrKYs4kWfNoHQg8ZG6PH4= ecdsa-key-20240131"
  ],
  "tags": [
    "project:odyssey",
    "env:build"
  ]
}

Response (201 Created) returns the VM object including its vmUuid and initial status (provisioning). The VM will transition through provisioning → starting → running. You can monitor its status using the GET VM endpoint.

Create a VM with Terraform

Similar to the API endpoint, you'll need an API token for using the Terraform provider. The procedure is documented in API v3 Authentication

Example Usage:

resource "i3dnet_flexvm_vm" "my-vm" {
  cloud_id           = "019256ab-1554-73a7-b091-f024b0a724ea"
  name               = "test-gaming-vm1"
  description        = "Test Gaming VM 1"
  instance_type_name = "vm.gpu.1rtx4000.30c.240g"
  image_name         = "ubuntu-2404-server-amd64"
  ssh_keys           = ["ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIHwdgjY0AlmkeLknBpoVmJg/quNSifyBHEK1MREpV4Ri [e-mail]"]
}

Deleting a VM

Use the DELETE /v3/flexVM/clouds/{cloudUuid}/vms/{vmUuid} endpoint with a JSON body.

Example request:

DELETE /v3/flexVM/clouds/{cloudUuid}/vms/{vmUuid}
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
{
}

The VM LVM disk and NVMe passthrough disk will be immediately wiped