---
title: "volume modify"
slug: "volume-modify"
tags: ["5.4"]
updated: 2026-10-28T01:53:01Z
published: 2026-10-28T01:53:01Z
canonical: "docs.vastdata.com/volume-modify"
---

> ## 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 modify

This command modifies a block storage volume. You can change the name and size, remove tags and add tags.

## Usage

```plaintext
volume modify --id ID
             [--name NAME]
             [--size SIZE]
             [--tags|--tags TAGS]
             [--enable-live-monitoring|--disable-live-monitoring]
```

## Required Parameters

| `--id ID` | Specifies which volume to modify. |
| --- | --- |

## Options

| `--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` | Use this option to expand the capacity of the volume. Specify `SIZE` as a number followed by GB or TB. For example: `--size 500GB`. |
| `--tags\|--tags TAGS` | Add or remove tags: - To remove all tags, specify `--tags` without an argument. - To remove all tags and add new ones, provide only the new tags. - To add tags without removing the existing tags, provide all old and new tags. Specify `TAGS` as a comma separated list of key-value pairs in format *<key>=<value>*. Encapsulate the list with quotation marks. For example: `--tags "team=backend,owner=BG"` |
| `--enable-live-monitoring` | Enables [live monitoring](/docs-5-4/docs/en/monitoring-views) for the volume. |
| `--disable-live-monitoring` | Disables [live monitoring](/docs-5-4/docs/en/monitoring-views) for the volume. |

## Example

```plaintext
vcli: admin> volume modify --id 1 --size 80GB
```