# images

Manage OS images.
Set management node URL:

# DELETE /images/{image}

Delete a downloaded image from disk

# Parameters

  • imagestring-

# Endpoint

curl -X DELETE http://mgmt-node:8080/api/images/{image} 

# GET /images/{image}/{file}

# Parameters

  • imagestring-
  • filestring-

# Endpoint

curl -X GET http://mgmt-node:8080/api/images/{image}/{file} 

# GET /images

# Parameters

  • No parameters...

# Endpoint

curl -X GET http://mgmt-node:8080/api/images 

# Response 200

  • lateststring-
  • defaultstring-
  • imagesarray-
    • idstring-
    • descriptionstring-
    • timestampinteger-
    • flagsarray-
    • downloadedboolean-
    • downloadingboolean-
    • progressinteger-
    • downloadErrorstring-
    • fileSizeinteger-

# Example response

{
  "latest": "string",
  "default": "string",
  "images": [
    {
      "id": "string",
      "description": "string",
      "timestamp": 0,
      "flags": [
        "string"
      ],
      "downloaded": true,
      "downloading": true,
      "progress": 0,
      "downloadError": "string",
      "fileSize": 0
    }
  ]
}

# POST /images/refresh

# Parameters

  • No parameters...

# Endpoint

curl -X POST http://mgmt-node:8080/api/images/refresh 

# Response 200

  • lateststring-
  • defaultstring-
  • imagesarray-
    • idstring-
    • descriptionstring-
    • timestampinteger-
    • flagsarray-
    • downloadedboolean-
    • downloadingboolean-
    • progressinteger-
    • downloadErrorstring-
    • fileSizeinteger-

# Example response

{
  "latest": "string",
  "default": "string",
  "images": [
    {
      "id": "string",
      "description": "string",
      "timestamp": 0,
      "flags": [
        "string"
      ],
      "downloaded": true,
      "downloading": true,
      "progress": 0,
      "downloadError": "string",
      "fileSize": 0
    }
  ]
}

# POST /images/default

# Parameters

  • bodyobject-
    • overrideServersboolean-
    • defaultstring-

# Endpoint

curl -X POST http://mgmt-node:8080/api/images/default 

# Example body

{
  "overrideServers": true,
  "default": "string"
}

# POST /images/{image}/startDownload

# Parameters

  • imagestring-

# Endpoint

curl -X POST http://mgmt-node:8080/api/images/{image}/startDownload 

# POST /servers/{id}/terminal/connect

Connect to the server via SSH.

# Parameters

  • idinteger-

# Endpoint

curl -X POST http://mgmt-node:8080/api/servers/{id}/terminal/connect 

# Response 200

  • pathstringConnect here.
  • tlsPortintegerConnect to this port for TLS.
  • plaintextPortintegerConnect to this port for an unencrypted connection.
  • authTokenstringPass as Authorization header.
  • validUntilintegerURL is valid until this time, existing connections stay connected afterwards.
  • iscsibooleanWhether this is a connection to an iSCSI gateway.

# Example response

{
  "path": "string",
  "tlsPort": 0,
  "plaintextPort": 0,
  "authToken": "string",
  "validUntil": 0,
  "iscsi": true
}