Skip to content

Mount an ISO image on a VPS

POST /api/v2/vps/{id}/iso/actions/mount

Puts an ISO image in a CD/DVD drive of the VPS and moves that drive first in the boot order. The VPS boots from the image the next time it starts. Take the image from available[] on GET /api/v2/vps/{id}/iso. A free slot gets a new drive. A slot that holds the cloud-init drive cannot be used and returns 403. Use POST /api/v2/vps/{id}/iso/actions/unmount to take the image out again.

Authentication: An API key with the scopes write:vm and write:storage and vm:write. About keys and scopes

Request

Path parameters

idstringrequired
The VPS ID (vps_…).

Body

isoIdstringrequired
The ISO ID (iso_…) from available[].id.
devicestring
The CD/DVD drive, ide0 to ide3. Default ide2. One of ide0, ide1, ide2, ide3.

Example

POST /api/v2/vps/{id}/iso/actions/mount
curl -X POST "https://cloud.hostup.se/api/v2/vps/vps_01hxa3b4c5d6e7f8g9h0j1k2m3/iso/actions/mount" \
-H "Authorization: Bearer $HOSTUP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"isoId": "iso_01hxa3b4c5d6e7f8g9h0j1k2m3",
"device": "ide2"
}'

Responses

200 The image is in the drive.

Response 200
{
"device": "ide2",
"isoId": "iso_01hxa3b4c5d6e7f8g9h0j1k2m3"
}
Response fields
devicestring
The drive that holds the image.
isoIdstring
The ISO ID from the request.

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

400Invalid request. The response body is an RFC 7807 Problem Details document.
401Unauthorized. Authentication is required.
403The slot holds the cloud-init drive.
404The VPS or the ISO image was not found. code is vps_not_found or not_found.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.