Vultr Customer Portal

Vultr API

1. Send a GET request to the List Instances endpoint and note the target instance’s ID.
   console

   $ curl "https://api.vultr.com/v2/instances" \
     -X GET \
     -H "Authorization: Bearer ${VULTR_API_KEY}"
   

2. Send a GET request to the List OS endpoint to view all available operating systems and note the target OS ID.
   console

   $ curl "https://api.vultr.com/v2/os" \
     -X GET \
     -H "Authorization: Bearer ${VULTR_API_KEY}"
   

3. Send a PATCH request to the Update Instance endpoint with a new os_id value to change the instance’s operating system.
   console

   $ curl "https://api.vultr.com/v2/instances/{instance-id}" \
   -X PATCH \
   -H "Authorization: Bearer ${VULTR_API_KEY}" \
   -H "Content-Type: application/json" \
   --data '{
     "os_id" : "new-instance-os_id"
   }'

Vultr CLI

1. List all instances in your Vultr account and note the target instance’s ID.
   console

   $ vultr-cli instance list
   

2. List all available operating systems and note the target OS ID.
   console

   $ vultr-cli instance os list <instance-id>
   

3. Change the target instance’s operating system.
   console

   $ vultr-cli instance os change <instance-id> --os <os_id>

Terraform

1. Open your Terraform configuration for the existing Cloud GPU instance.
2. Update the os_id value in the instance resource to the new operating system ID.
   terraform

   resource "vultr_instance" "gpu" {
       # ...existing fields (region, plan, label, etc.)
   
       os_id = 1743  # Example: Ubuntu 22.04 LTS x64
   }
   

3. Apply the configuration and observe the following output:

   Apply complete! Resources: 0 added, 1 changed, 0 destroyed.