volume create

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

Usage

 volume create --view-id ID
               --name
               --size
              [--tags TAGS]

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

Example

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