Skip to main content
POST
/
kvm
/
v2
/
get
/
images
Get autoinstall images
curl --request POST \
  --url https://{api_host}/kvm/v2/get/images \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data signature=session_signature_12345 \
  --data kvm_id=kvm_xxxxx_yyyyy \
  --data valid_until=1737476000
{
  "data": [
    "cloudinit_almalinux-8",
    "cloudinit_almalinux-9",
    "cloudinit_arch-linux_20231115",
    "cloudinit_centos-7",
    "cloudinit_centos-stream-8",
    "cloudinit_centos-stream-9",
    "cloudinit_debian-bookworm",
    "cloudinit_rocky-9",
    "cloudinit_ubuntu-lts-16-04",
    "cloudinit_ubuntu-lts-18-04",
    "cloudinit_ubuntu-lts-20-04",
    "cloudinit_ubuntu-lts-22-04",
    "cloudinit_ubuntu-lts-24-04",
    "debian-bullseye",
    "debian-buster",
    "debian-stretch",
    "windows-10",
    "windows-server-2016",
    "windows-server-2019",
    "windows-server-2022"
  ],
  "status": "success"
}

Body

application/x-www-form-urlencoded

Required parameters to retrieve the list of autoinstall images.
All parameters must be passed in the request body as application/x-www-form-urlencoded.

​
signature
string

The session signature obtained from the "Create AUTH-session" call.

Example:

"session_signature_12345"

​
kvm_id
string

The unique identifier of the KVM VPS for which the autoinstall images are being retrieved.
This value is specific to your VPS.

Example:

"kvm_xxxxx_yyyyy"

​
valid_until
string

The expiration timestamp for the session, as obtained from the "Create AUTH-session" call.
Ensure that the session is valid and has not expired.

Example:

"1737476000"

Response

A list of available autoinstall images retrieved successfully.

​
data
string[]
Example:
[
  "cloudinit_almalinux-8",
  "cloudinit_almalinux-9",
  "cloudinit_arch-linux_20231115",
  "cloudinit_centos-7",
  "cloudinit_centos-stream-8",
  "cloudinit_centos-stream-9",
  "cloudinit_debian-bookworm",
  "cloudinit_rocky-9",
  "cloudinit_ubuntu-lts-16-04",
  "cloudinit_ubuntu-lts-18-04",
  "cloudinit_ubuntu-lts-20-04",
  "cloudinit_ubuntu-lts-22-04",
  "cloudinit_ubuntu-lts-24-04",
  "debian-bullseye",
  "debian-buster",
  "debian-stretch",
  "windows-10",
  "windows-server-2016",
  "windows-server-2019",
  "windows-server-2022"
]
​
status
string

The status of the operation.

Example:

"success"