volume modify

Prev Next

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

Usage

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 for the volume.

--disable-live-monitoring

Disables live monitoring for the volume.

Example

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