---
title: "Get a disk"
method: GET
path: "/v1/projects/{projectId}/disks/{id}"
tags: ["Disks"]
---

# Get a disk

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

Retrieves the details of a virtual machine disk.

## Path parameters

- `projectId` string, required
- `id` string, required

## Response `200`

A successful response.

- GetDiskResponse
  - `disk` 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

## 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)