---
title: "volume create"
slug: "volume-create"
tags: ["5.5"]
updated: 2026-10-27T23:00:54Z
published: 2026-10-27T23:00:54Z
canonical: "docs.vastdata.com/volume-create"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# volume create

This command creates a volume of block storage on a block enabled view.

> [!NOTE]
> Note
> 
> You cannot create block volumes at or inside the target protected path while an async replication stream is in active state.

## Usage

```plaintext
 volume create --view-id ID
               --name
               --size
              [--tags TAGS]
              [--qos-policy-id ID]
```

## Required Parameters

| `--view id ID` | Specifies which block subsystem view under which to provision the volume. Specify the integer ID of a view that is configured for block storage (has the block protocol enabled). |
| --- | --- |
| `--name NAME` | Modifies the volume name, which is the path to the volume relative to the subsystem view to which it belongs. The path can include a nesting of subdirectories. Subdirectories that do not yet exist will be created accordingly when the name is configured. Examples: - To place the volume directly under the subsystem view to which it belongs and name it *block1*: `--name block1`. - To place the volume under a subdirectory called *blocks* under the subsystem view to which it belongs and name it *block1*: `--name blocks/block1`. |
| `--size SIZE` | Modifies the capacity of the volume. Specify `SIZE` as a number followed by GB or TB. For example: `--size 500GB`. |

## Options

| `--tags TAGS` | Adds key-value pairs to tag the volume, for the purpose of categorizing and organizing block volumes. Specify `TAGS` as a comma separated list of key-value pairs in format *<key>=<value>*. For example: `--tags team=backend,owner=BG` |
| --- | --- |
| `--qos-policy-id ID` | Assigns a QoS policy to the volume. |

## Example

```plaintext
vcli: admin> volume create --view-id 3 --name dev/platform --size 100GB --tags owner=DG,team=platform
```