v32

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

Images

List bare metal images

Retrieve a list of available images for bare metal servers. The list can be filtered by visibility, tags, and other parameters. Returned entities may or may not be owned by the project.

get/cloud/v1/bmimages/{project_id}/{region_id}

Path parameters

project_idinteger required

Project ID

Example:1

Project ID

region_idinteger required

Region ID

Example:7

Region ID

Query parameters

include_pricesboolean

Show price.

privatestring

Any value to show private images

tag_keystring[]

Optional. Filter by tag keys. ?tag_key=key1&tag_key=key2

[
  "key1",
  "key2"
]

tag_key_valuestring

Optional. Filter by tag key-value pairs.

visibility'private' | 'public' | 'shared'

Image visibility. Globally visible images are public

Response

countinteger required

Number of objects

Example response

{
  "count": 1,
  "results": [
    {
      "created_at": "2024-05-05T14:51:26.570866Z",
      "creator_task_id": "b10dd116-07f5-4225-abb7-f42da5cb78fb",
      "currency_code": "USD",
      "description": "string",
      "disk_format": "raw",
      "display_order": 2010,
      "gpu_driver": "nvidia",
      "gpu_driver_type": "open",
      "gpu_driver_version": "570.148.08",
      "id": "44e136a7-15c1-4b5f-a086-20b7b3237d40",
      "is_baremetal": true,
      "min_disk": 3,
      "name": "ubuntu-20.10-x64",
      "os_distro": "ubuntu",
      "os_version": "20.10",
      "project_id": 1337,
      "region": "Luxembourg 1",
      "region_id": 7,
      "size": 2361393152,
      "status": "active",
      "tags": [
        {
          "key": "my-tag",
          "read_only": false,
          "value": "my-tag-value"
        }
      ],
      "updated_at": "2024-05-05T14:51:26.570866Z",
      "visibility": "public"
    }
  ]
}