Attach an ISO to a Server

POST

/servers/{id}/actions/attach_iso

Attaches an ISO to a Server. The Server will immediately see it as a new disk. An already attached ISO will automatically be detached before the new ISO is attached.

Servers with attached ISOs have a modified boot order: They will try to boot from the ISO first before falling back to hard disk.

Request

Path Params

Body Params application/json

Examples

Responses

🟢201The `action` key in the reply contains an Action object with this structure

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.hetzner.cloud/v1/servers//actions/attach_iso' \
--header 'Content-Type: application/json' \
--data-raw '{
    "iso": "FreeBSD-11.0-RELEASE-amd64-dvd1"
}'

Response Example

{
    "action": {
        "command": "attach_iso",
        "error": {
            "code": "action_failed",
            "message": "Action failed"
        },
        "finished": null,
        "id": 13,
        "progress": 0,
        "resources": [
            {
                "id": 42,
                "type": "server"
            }
        ],
        "started": "2016-01-30T23:50:00.000Z",
        "status": "running"
    }
}

Modified at 2023-08-16 03:09:21

Add a Server to a Placement Group

Attach a Server to a Network