---
title: "Block Storage Volume"
description: "Block Storage Volume object in the Exoscale API reference."
url: https://community.exoscale.com/reference/api/_schemas/block-storage-volume/
section: reference
last_updated: 2026-10-14
---
> For AI agents: the documentation index is at https://community.exoscale.com/llms.txt. Every page is available as markdown at `<page URL>index.md` or with `Accept: text/markdown`.

# Block Storage Volume

Block storage volume

## Properties

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `block-storage-snapshots` | array of [Target block storage snapshot](https://community.exoscale.com/reference/api/_schemas/block-storage-snapshot-ref/index.md) | no | Volume snapshots, if any |
| `blocksize` | integer | no | Volume block size<br/><br/>Min: `0`. |
| `created-at` | string | no | Volume creation date<br/><br/>ISO 8601 date-time. |
| `encrypted` | boolean | no | Indicates if the block-storage volume is encrypted |
| `id` | string | no | Volume ID<br/><br/>Must be a valid UUID. |
| `instance` | [Target Instance](https://community.exoscale.com/reference/api/_schemas/instance-ref/index.md) | no | Volume attached instance, if any |
| `labels` | object | no | Resource labels |
| `name` | string | no | Volume name<br/><br/>Min length: `1`. Max length: `255`. |
| `size` | integer | no | Volume size<br/><br/>Min: `1`. |
| `state` | string | no | Volume state<br/><br/>Allowed values: `snapshotting`, `deleted`, `creating`, `detached`, `deleting`, `attaching`, `error`, `attached`, `detaching`. |