Volumes

Manage block storage volumes: create, list, inspect, update, extend, and delete.

---

Types

List available volume types with pricing and performance specifications.

ace volume types

Example output:

NAME                                     CURRENCY  PRICE/GB/MO   MIN GB   MAX GB   MAX IOPS   MAX MB/s
NVMe based High IOPS Storage            INR       30.0000        10       1000     50000       500
Standard HDD Storage                     INR       10.0000        10       5000     3000        150

Tip: Use the full volume type name (e.g. "NVMe based High IOPS Storage") when creating volumes.

---

Create

Create a new block storage volume.

ace volume create \
  --name <volume-name> \
  --type <volume-type> \
  [--size <gb>] \
  [--description <text>] \
  [--billing-type <type>]

Flags

Flag	Default	Description
--name		Volume name (required)
--type		Volume type name (required, use ace volume types to list)
--size	10	Volume size in GB
--description		Volume description (max 255 chars)
--billing-type	hourly	Billing type

Examples

# Basic volume
ace volume create --name my-data --size 50 --type "NVMe based High IOPS Storage"

# With description
ace volume create \
  --name db-storage \
  --size 200 \
  --type "NVMe based High IOPS Storage" \
  --description "PostgreSQL data volume"

Example output:

Volume created.
  ID:              xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  Name:            my-data
  Size:            50 GB
  Type:            NVMe based High IOPS Storage
  Status:          creating

---

List

List all volumes in the current project.

ace volume list [--status <status>] [--bootable <true|false>]

Flags

Flag	Description
--status	Filter by status (e.g. available, in-use, creating)
--bootable	Filter by bootable flag (true or false)

Examples

# List all volumes
ace volume list

# List only available (unattached) volumes
ace volume list --status available

# List only bootable volumes
ace volume list --bootable true

Example output:

ID                                     NAME                   SIZE   STATUS       TYPE         BOOTABLE   ATTACHED TO
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx   my-data                50GB   available    NVMe...      false      -
yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy   boot-vol              100GB   in-use       NVMe...      true       abc123abc12...

---

Get / Show

Get detailed information about a specific volume.

ace volume get <volume-id>

Aliases: show, describe

Example output:

ID:                    xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Name:                  my-data
Status:                available
Size:                  50 GB
Type:                  NVMe based High IOPS Storage
Bootable:              false
Availability Zone:     nova
Encrypted:             false
Multiattach:           false
Created:               2025-03-20T10:00:00Z
Updated:               2025-03-20T10:01:00Z

Attachments:
  Server: instance-uuid  Device: /dev/vdb

---

Update

Update a volume's name or description.

ace volume update <volume-id> [--name <new-name>] [--description <new-desc>]

At least one of --name or --description must be specified.

Examples

# Rename a volume
ace volume update <volume-id> --name new-name

# Update description
ace volume update <volume-id> --description "Updated description"

# Both
ace volume update <volume-id> --name new-name --description "New desc"

---

Extend

Increase the size of a volume. Volumes can only be extended (made larger), never shrunk.

ace volume extend <volume-id> --size <new-size-gb>

Flags

Flag	Description
--size	New size in GB (required, must be larger than current size)

Example

ace volume extend <volume-id> --size 100

Volume xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx extended to 100 GB.

---

Delete

Delete one or more volumes.

ace volume delete <volume-id> [volume-id...]

Aliases: rm

Examples

# Delete single volume
ace volume delete <volume-id>

# Delete multiple volumes
ace volume delete <id1> <id2> <id3>

Deleted 3 volume(s).

Note: A volume must be detached from all instances before it can be deleted.

---

Global Flags

Flag	Description
-o, --output	Output format: table (default) or json
--project	Override project ID
--region	Override region