Sign in

v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
GPU Virtual

Update virtual GPU image

Update GPU image name, min_disk, min_ram, or tags.

patch/cloud/v3/gpu/virtual/{project_id}/{region_id}/images/{image_id}

Path parameters

project_idinteger required

Project ID

Example:1

Project ID

region_idinteger required

Region ID

Example:7

Region ID

image_idstring required

Image ID

Example:8cab6f28-09ca-4201-b3f7-23c7893f4bd6

Image ID

Request body

min_diskinteger

Minimal boot volume required (GB)

min_raminteger

Minimal RAM required (MB)

namestring

Image display name

tagsUpdateTagsSerializer

Example request

{
  "min_disk": 20,
  "name": "my-gpu-image"
}

Response

OK

architecturestring nullable

Image architecture type

created_atstring date-time required

Datetime when the image was created

gpu_driverstring nullable

Name of the GPU driver vendor

gpu_driver_typestring nullable

Type of the GPU driver

gpu_driver_versionstring nullable

Version of the installed GPU driver

idstring uuid4 required

Image ID

min_diskinteger required

Minimal boot volume required

min_raminteger required

Minimal VM RAM required

namestring required

Image name

os_distrostring nullable

OS Distribution

os_typestring nullable

The operating system installed on the image

os_versionstring nullable

OS version, i.e. 19.04 (for Ubuntu) or 9.4 for Debian

sizeinteger

Image size in bytes.

ssh_keystring nullable

Whether the image supports SSH key or not

statusstring required

Image status

task_idstring nullable

The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If null, the resource is not locked.

updated_atstring date-time required

Datetime when the image was updated

visibilitystring required

Image visibility. Globally visible images are public

Example response

{
  "architecture": "x86_64",
  "created_at": "2024-05-05T14:51:26.570866Z",
  "gpu_driver": "nvidia",
  "gpu_driver_type": "open",
  "gpu_driver_version": "570.148.08",
  "id": "44e136a7-15c1-4b5f-a086-20b7b3237d40",
  "min_disk": 1,
  "name": "ubuntu-23.10-x64",
  "os_distro": "ubuntu",
  "os_type": "linux",
  "os_version": "19.04",
  "size": 3758096384,
  "ssh_key": "allow",
  "status": "active",
  "tags": [
    {
      "key": "my-tag",
      "read_only": false,
      "value": "my-tag-value"
    }
  ],
  "updated_at": "2024-05-05T14:51:26.570866Z",
  "visibility": "public"
}