Images

The images are the operating systems natively installable on our servers, as opposed to the Templates are public and available to all.

Getting the base images.

To get all active base images you can use the following request:

HTTP request

GET /ecs/v2/images/basics

HTTP Response

{
  "status": "ok",
  "images": [
     {
        "id": 1, //image id
        "name": "centos-7", //image code
        "creation_date": "2019-04-16T13:37:41+00:00",
        "active_flag": true,
        "status": "CD",
        "uuid": "ffe2a034-7a44-4f51-9ae8-17fb354793f6",
        "description": "CentOS Linux 7", //a public description of the specific version
        "notes": "Linux CentOS disk image", //an internal note
        "public": true,
        "cloud_image": false,
        "so_base": "centos", //base os
        "api_version": "v4",
        "version": "7" //base os version
     },
     {
        "id": 2,
        "name": "debian-9",
        "creation_date": "2019-04-18T12:34:08+00:00",
        "active_flag": true,
        "status": "CD",
        "uuid": "6708cdc4-0c8d-4ccf-83c7-ae39bccaeb42",
        "description": "Debian Linux 9",
        "notes": "Linux Debian disk image",
        "public": true,
        "cloud_image": false,
        "so_base": "debian",
        "api_version": "v4",
        "version": "9"
     },
    ...
  ]
}

Getting Cloud Images.

Cloud images are essentially base images customized in a manner similar to Cloud Scripts.

In contrast to Cloud Scripts they are usable at the image level and are closely linked to the operating system from which they are derived.

The following request can be used to view active cloud images:

HTTP request

GET /ecs/v2/images/cloud-images

HTTP Response

{
  "status": "ok",
  "images": [
    {
      "id": 40,
      "name": "sci-gpu-seeweb-ai-ubuntu-2204",
      "creation_date": "2024-06-24T10:44:15.494000+00:00",
      "active_flag": true,
      "status": "CD",
      "uuid": "2d41e9c4-280d-423b-8110-9d14173f601c",
      "description": "Python AI Toolkit",
      "notes": "Seeweb AI Toolkit - Ubuntu Linux 22.04 LTS",
      "public": true,
      "cloud_image": true,
      "so_base": "ubuntu",
      "api_version": "v4",
      "version": "2204"
    },
     {
      "id": 41,
      "name": "sci-gromacs-2022.2-ubuntu-2204",
      "creation_date": "2024-06-24T10:44:41.206000+00:00",
      "active_flag": true,
      "status": "CD",
      "uuid": "2d41e9c4-280d-423b-8110-9d14173f601c",
      "description": "Gromacs 2022.2",
      "notes": "Gromacs 2022.2 inside docker on Ubuntu Linux 22.04 LTS",
      "public": true,
      "cloud_image": true,
      "so_base": "ubuntu",
      "api_version": "v4",
      "version": "2204"
    },
  ]
}