Get service volume
GEThttps://api.instacloud.com/projects/{projectId}/services/{serviceId}/volume
Token scope: account · org · project — read-only tokens allowed.
A compute or managed-database service's data volume (size + mount path — configurable on attachment for compute, the image's data directory for a managed DB; null when none is attached) plus this plan's volume cap.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
projectId | path | string | yes | |
serviceId | path | string | yes |
Responses
200
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
volume | object | null | yes | null = no volume attached (attach one any time with PUT …/volume) |
volume.sizeGib | integer | yes | |
volume.mountPath | string | yes | configured container mount path (defaults to /data for compute) |
volume.id | string | null | no | |
volume.appliedMountPath | string | null | no | |
volume.pending | boolean | no | |
cap | object | yes | |
cap.volumeGib | integer | yes | this plan's maximum volume size (whole Gi) |
400
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |
404
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |