Skip to main content

Overview

Deleting a VM permanently removes it from your account. This stops all billing for the VM and releases all associated resources including IP addresses.

Prerequisites

export RAFF_API_KEY="YOUR_API_KEY"
export RAFF_PROJECT_ID="YOUR_PROJECT_ID"

Delete a VM

curl -X DELETE -H "X-API-Key: $RAFF_API_KEY" -H "X-Project-ID: $RAFF_PROJECT_ID" \
  https://api.rafftechnologies.com/api/v1/vms/{vm-id}
Deleting a VM is permanent and cannot be undone. All data on the VM will be lost. Make sure to back up any important data first.

What Happens When You Delete a VM

  1. VM is terminated — the VM is immediately shut down and removed
  2. IP address released — the public IPv4/IPv6 address is returned to the pool
  3. Billing stops — hourly charges cease immediately
  4. Usage log frozen — the current billing period’s accumulated_cost is preserved for final invoicing
  5. Attached volumes — block storage volumes are detached but not deleted (you must delete them separately)
  6. Backups retained — existing backup files are retained until their expiration date
  7. Snapshots retained — existing snapshots remain and continue to be billed

Before Deleting

Consider these steps before deleting a VM:
  1. Back up your data — create a snapshot or download important files
  2. Check attached volumes — volumes will be detached but not deleted
  3. Note your IP address — once released, you cannot reclaim the same IP
  4. Check backup schedules — delete associated backup schedules if no longer needed

Delete Associated Resources

After deleting a VM, clean up related resources to stop billing:

Delete Snapshots

Snapshots of the deleted VM continue to be billed. Delete them if no longer needed.

Delete Backup Schedules

Backup schedules associated with the VM should be removed to prevent orphaned backup policies.

Delete Volumes

Detached volumes continue to be billed. Delete them if the data is no longer needed.

Next Steps