> ## Documentation Index
> Fetch the complete documentation index at: https://vastai-80aa3a82-auto-cli-sdk-preview-pr-398.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# vastai list volume

\[Host] list disk space for rent as a volume on a machine

## Usage

```bash theme={null}
vastai list volume ID [options]
```

## Arguments

<ParamField path="id" type="integer" required>
  id of machine to list
</ParamField>

## Options

<ParamField path="--price_disk" type="number" default="0.1">
  storage price in $/GB/month, default: $%(default).2f/GB/month
</ParamField>

<ParamField path="--end_date" type="string">
  contract offer expiration - the available until date (optional, in unix float timestamp or MM/DD/YYYY format), default 3 months
</ParamField>

<ParamField path="--size" type="string" default="15">
  size of disk space allocated to offer in GB, default %(default)s GB
</ParamField>

## Description

Allocates a section of disk on a machine to be used for volumes.

## Global Options

The following options are available for all commands:

| Option          | Description                                           |
| --------------- | ----------------------------------------------------- |
| `--url URL`     | Server REST API URL                                   |
| `--retry N`     | Retry limit                                           |
| `--raw`         | Output machine-readable JSON                          |
| `--explain`     | Verbose explanation of API calls                      |
| `--api-key KEY` | API key (defaults to `~/.config/vastai/vast_api_key`) |