---
title: "List disks"
method: GET
path: "/v1/projects/{projectId}/disks"
tags: ["Disks"]
---

# List disks

`GET /v1/projects/{projectId}/disks`

Lists virtual machine disks in a project.

## Path parameters

- `projectId` string, required

## Query parameters

- `pageNumber` integer
- `pageSize` integer
- `dataCenterId` string

## Response `200`

A successful response.

- ListDisksResponse
  - `disks` Disk[]
    - `createTime` string, date-time
    - `dataCenterId` string, required
    - `diskState` 'UNKNOWN' | 'ATTACHED' | 'CLONING' | 'CREATING' | 'DELETING' | 'DISABLED' | 'FAILED' | 'READY' | 'UPDATING'
    - `diskType` 'DISK_TYPE_UNKNOWN' | 'DISK_TYPE_BOOT' | 'DISK_TYPE_STORAGE'
    - `id` string, required
    - `privateImageId` string
    - `projectId` string, required
    - `publicImageId` string
    - `sizeGib` integer, required
    - `vmId` string
  - `pageNumber` integer, required
  - `pageSize` integer, required
  - `totalCount` integer, required

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/cudocompute/apis/cudo-compute-service.md) · [All operations](https://skmtc.net/cudocompute/apis/cudo-compute-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cudocompute/cudo-compute-service/revisions/93dc40dababc/schema)