# blockstore-api ## Pages - [EZGH Block Storage API](https://docs.ezghcloud.com/blockstore-api/index.md) — Encrypted block storage volumes and their snapshots, in a project. Every path is under an organization; lists are paged with limit, cursor and nextCursor. Byte counts are decimal strings; throughput is in MB/s (10^6 bytes per second). The volume types are public at GET /public/v1/volume-types. - [Cancel an operation](https://docs.ezghcloud.com/blockstore-api/CancelOperation/index.md) — 409 operation_finished or operation_not_cancellable when it can't be cancelled. - [Snapshot a volume](https://docs.ezghcloud.com/blockstore-api/CreateSnapshot/index.md) — Asynchronous: 202 with the CreateSnapshot operation. Crash-consistent. - [Create a volume](https://docs.ezghcloud.com/blockstore-api/CreateVolume/index.md) — Asynchronous: 202 with the CreateVolume operation and the volume (creating). Empty, from an image (resolved now) or from a snapshot (keeping its type). 409 insufficient_capacity when no storage of the type admits it now. - [Delete a snapshot](https://docs.ezghcloud.com/blockstore-api/DeleteSnapshot/index.md) — Asynchronous: 202 with the DeleteSnapshot operation. - [Delete a volume](https://docs.ezghcloud.com/blockstore-api/DeleteVolume/index.md) — Asynchronous: 202 with the DeleteVolume operation. 409 volume_in_use while attached; 409 deletion_protection_enabled while protected. Its snapshots stay. - [Get an operation (poll it until it finishes)](https://docs.ezghcloud.com/blockstore-api/GetOperation/index.md) — While it's queued or running, Retry-After suggests when to poll again. Not recorded in Trails. - [Get a snapshot](https://docs.ezghcloud.com/blockstore-api/GetSnapshot/index.md) - [Get a volume](https://docs.ezghcloud.com/blockstore-api/GetVolume/index.md) - [List the organization's operations, newest first](https://docs.ezghcloud.com/blockstore-api/ListOperations/index.md) - [List the volume types the organization can use](https://docs.ezghcloud.com/blockstore-api/ListOrganizationVolumeTypes/index.md) - [List a project's snapshots, newest first](https://docs.ezghcloud.com/blockstore-api/ListSnapshots/index.md) - [List a project's volumes, newest first](https://docs.ezghcloud.com/blockstore-api/ListVolumes/index.md) - [Grow a volume or change its IOPS and throughput, live](https://docs.ezghcloud.com/blockstore-api/ModifyVolume/index.md) — Asynchronous: 202 with the ModifyVolume operation. Grow only; one change at a time. - [Rename or retag a snapshot](https://docs.ezghcloud.com/blockstore-api/UpdateSnapshot/index.md) - [Rename or retag a volume, or set its deletion protection](https://docs.ezghcloud.com/blockstore-api/UpdateVolume/index.md) - [Error](https://docs.ezghcloud.com/blockstore-api/schemas/Error/index.md) — Every non-2xx answer. Clients branch on code, never on message. - [Operation](https://docs.ezghcloud.com/blockstore-api/schemas/Operation/index.md) - [OperationList](https://docs.ezghcloud.com/blockstore-api/schemas/OperationList/index.md) - [OperationStatus](https://docs.ezghcloud.com/blockstore-api/schemas/OperationStatus/index.md) - [QuotaExceeded](https://docs.ezghcloud.com/blockstore-api/schemas/QuotaExceeded/index.md) — quota_exceeded: the quota that refused the request. Never with Retry-After. - [Snapshot](https://docs.ezghcloud.com/blockstore-api/schemas/Snapshot/index.md) - [SnapshotCreate](https://docs.ezghcloud.com/blockstore-api/schemas/SnapshotCreate/index.md) - [SnapshotList](https://docs.ezghcloud.com/blockstore-api/schemas/SnapshotList/index.md) - [SnapshotStatus](https://docs.ezghcloud.com/blockstore-api/schemas/SnapshotStatus/index.md) - [SnapshotUpdate](https://docs.ezghcloud.com/blockstore-api/schemas/SnapshotUpdate/index.md) - [Tags](https://docs.ezghcloud.com/blockstore-api/schemas/Tags/index.md) — At most 50; keys 1-128 characters, values at most 256, keys starting with ezgh: are reserved. - [Volume](https://docs.ezghcloud.com/blockstore-api/schemas/Volume/index.md) - [VolumeAttachment](https://docs.ezghcloud.com/blockstore-api/schemas/VolumeAttachment/index.md) - [VolumeCreate](https://docs.ezghcloud.com/blockstore-api/schemas/VolumeCreate/index.md) - [VolumeList](https://docs.ezghcloud.com/blockstore-api/schemas/VolumeList/index.md) - [VolumeModify](https://docs.ezghcloud.com/blockstore-api/schemas/VolumeModify/index.md) - [VolumeSource](https://docs.ezghcloud.com/blockstore-api/schemas/VolumeSource/index.md) - [VolumeStatus](https://docs.ezghcloud.com/blockstore-api/schemas/VolumeStatus/index.md) - [VolumeType](https://docs.ezghcloud.com/blockstore-api/schemas/VolumeType/index.md) - [VolumeTypeList](https://docs.ezghcloud.com/blockstore-api/schemas/VolumeTypeList/index.md) - [VolumeUpdate](https://docs.ezghcloud.com/blockstore-api/schemas/VolumeUpdate/index.md)