---
title: "List Images"
method: GET
path: "/compute/v2/thr3/images"
tags: ["Compute"]
---

# List Images

`GET /compute/v2/thr3/images`

Retrieves a list of all available operating system images that can be used when creating compute instances.
Images define the base operating system and pre-installed software that will be deployed on your instances.

## Response `200`

Successfully retrieved the list of available images. The response includes details about each image
such as the operating system type, version, and other specifications to help you choose the appropriate 
base system for your workloads.

- Anonymous87bd8cdd
  - `apiVersion` string, required — Version identifier of the API schema
  - `items` Anonymous6a739324, required — Collection of Image resources
    - `apiVersion` 'compute/v2', required — Version identifier of the API schema
    - `kind` 'Image', required — The string value 'Image' that identifies the schema
    - `metadata` Anonymousaa7ac512, required — Standard resource metadata fields
      - `annotations` object, required — Annotations are key-value pairs storing additional metadata about resources
      - `creationTimestamp` string, date-time, required
      - `deletionTimestamp` string, date-time, required
      - `labels` object, required — Labels are key-value pairs attached to resources for organization and categorization
      - `name` string, required — User-provided name that uniquely identifies the resource within its workspace and type
      - `ownerReferences` Anonymous6efd6cb9, required — References to other resources that own or manage the resource
        - `apiVersion` string, required
        - `blockOwnerDeletion` boolean, nullable
        - `controller` boolean, nullable
        - `kind` string, required
        - `name` string, required
        - `uid` string, required
      - `resourceVersion` string — An opaque value representing the internal version of this object that can be used for optimistic concurrency and change detection
      - `uid` string, required — System-generated unique identifier for the resource
      - `workspace` string, required — Unique identifier of the workspace where the resource belongs
    - `spec` Anonymousc7d6e5c2, required — Desired configuration and characteristics for the image
      - `description` string — A brief description of the image.
      - `distributionName` string — The distribution name of the operating system.
      - `osType` 'linux' | 'windows' — The operating system of the image.
      - `osVersion` string — The version of the operating system.
      - `public` boolean, required — Indicates whether the image is public.
    - `status` Anonymous14b4d106, required — Current observed state and conditions of the image
      - `creationFailed` boolean — Indicates if the image creation has failed.
      - `size` integer — The size of the image in bytes.
  - `kind` 'ImageList', required — The string value 'ImageList' that identifies the schema
  - `metadata` Anonymousa84d7754, required — Standard metadata fields for the list
    - `continue` string
    - `remainingItemCount` integer, nullable
    - `resourceVersion` string
    - `selfLink` string

## Other responses

- `400` — Bad request - invalid configuration provided
- `403` — Forbidden - insufficient permissions

---

[API](https://skmtc.dev/sotoon/apis/sotoon-api.md) · [All operations](https://skmtc.dev/sotoon/apis/sotoon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sotoon/sotoon-api/revisions/c937cd9861c5/schema)