Skip to main content
Rebuilding a virtual instance reinstalls its operating system using either the current image or another public image available in the same region. The same operation can replace the SSH key or provide new user data.
The operation replaces all data on the boot volume.
The API returns a task ID. The instance enters REBUILD while that task runs. The task reaches FINISHED before status returns to ACTIVE, and metadata.image_name still names the previous image until then.
An API token is required, along with a project ID and a region ID.

Rebuild the instance

IMAGE_ID is a public image ID from the Images API. my-key is the name of an SSH key already registered in the project, and user_data must be valid base64.