Virtual machine: Reimage

The reimage endpoint allows a virtual machine to be re-installed from a clean operating system image and returned to the same state as a new machine.

Re-image requests can only be made against a powered-off virtual machine.

Endpoint

Relative to https://uk0.bigv.io

POST /accounts/{account-id}/groups/{group-id}/virtual_machines/{vm-id}/reimage

Attributes

  • distribution – the name of a distribution; valid options are available by calling GET /definitions.
  • root_password – the root password the machine should have after re-imaging.
  • ssh_public_key – if specified, the contents of /root/.ssh/authorized_keys (for Linux distributions). Allows passwordless login.
  • firstboot_script – if specified, an arbitrary executable to be run on first boot (for Linux distributions). This should be a full, executable script, probably starting #!/bin/sh

Example

Request
POST /accounts/123/groups/default/virtual_machines/45/reimage
Curl
curl -H "Content-type: application/json" \
     -H "Authorization: Bearer {session-id}" \
     -X POST \
     -d '{"distribution":"jessie","root_password":"mysecurepassword"}' \
     https://uk0.bigv.io/accounts/123/groups/default/virtual_machines/45/reimage
Response (success: 200)
{
  "distribution": "wheezy",
  "root_password": "mysecurepassword"
}
Bytemark Cloud used to be called "BigV"—nothing has changed except the name! We’re hiring! Please visit careers.bytemark.co.uk to find out more.