Skip to main content
Version: 0.0.14

Block Storage Management

Block storage volumes are persistent storage devices that can be attached to virtual machines in Aruba Cloud.

Available Commands​

  • acloud storage blockstorage create - Create a new block storage volume
  • acloud storage blockstorage list - List all block storage volumes
  • acloud storage blockstorage get - Get details of a specific volume
  • acloud storage blockstorage update - Update volume name and tags
  • acloud storage blockstorage delete - Delete a block storage volume

Create Block Storage​

Create a new block storage volume in your project.

Usage​

acloud storage blockstorage create --name <name> --region <region> --size <size-gb> [flags]

Required Flags​

  • --name - Name for the block storage volume
  • --size - Size in GB (must be greater than 0)

Optional Flags​

  • --project-id - Project ID (uses context if not specified)
  • --region - Region code (default: "ITBG-Bergamo")
  • --zone - Zone/datacenter (optional)
  • --type - Volume type: Standard or Performance (default: "Standard")
  • --billing-period - Billing period: Hour, Month, Year (default: "Hour")
  • --tags - Tags (comma-separated)

Example​

# Create a 50GB standard block storage
acloud storage blockstorage create \
  --name "my-data-volume" \
  --region "ITBG-Bergamo" \
  --size 50 \
  --type "Standard" \
  --billing-period "Hour" \
  --tags "env,production"

Output​

Creating block storage with:
  Name: my-data-volume
  Region: ITBG-Bergamo
  Size: 50 GB
  Type: Standard
  Billing Period: Hour
  Project ID: 68398923fb2cb026400d4d31

Block storage created successfully!
ID:              69455aa70d0972656501d45d
Name:            my-data-volume
Size (GB):       50
Type:            Standard
Zone:            DC-BG-IT-1
Region:          ITBG-Bergamo
Status:          NotUsed
Creation Date:   18-12-2025 18:49:06

List Block Storage​

List all block storage volumes in your project.

Usage​

acloud storage blockstorage list [flags]

Flags​

  • --project-id - Project ID (uses context if not specified)
  • -v, --verbose - Show detailed debug information

Example​

acloud storage blockstorage list

Output​

NAME              ID                          SIZE(GB)  REGION  ZONE         TYPE       STATUS
my-data-volume    69455aa70d0972656501d45d   50        ITBG-Bergamo   DC-BG-IT-1   Standard   NotUsed
app-volume        69455bb80d0972656501d45e   100       ITBG-Bergamo   DC-BG-IT-1   Standard   Used

Get Block Storage Details​

Get detailed information about a specific block storage volume.

Usage​

acloud storage blockstorage get <volume-id> [flags]

Arguments​

  • volume-id - The ID of the block storage volume

Flags​

  • --project-id - Project ID (uses context if not specified)

Auto-completion​

Volume IDs support auto-completion. Press TAB after typing the command to see available volumes:

acloud storage blockstorage get <TAB>
# Shows:
# 6965a6c3ffc0fd1ef8ba5612    MyVolume
# 6965a6c3ffc0fd1ef8ba5613    DataVolume

Example​

acloud storage blockstorage get 69455aa70d0972656501d45d

Output​

Block Storage Details:
======================
ID:              69455aa70d0972656501d45d
URI:             /projects/68398923fb2cb026400d4d31/providers/Aruba.Storage/blockStorages/69455aa70d0972656501d45d
Name:            my-data-volume
Size (GB):       50
Type:            Standard
Zone:            DC-BG-IT-1
Region:          ITBG-Bergamo
Bootable:        false
Status:          NotUsed
Creation Date:   18-12-2025 18:49:06
Created By:      aru-297647
Tags:            [env production]

Update Block Storage​

Update the name and/or tags of a block storage volume.

Note: Size updates are not currently supported by the API. Volume must be in "Used" or "NotUsed" status to be updated.

Usage​

acloud storage blockstorage update <volume-id> [flags]

Arguments​

  • volume-id - The ID of the block storage volume (supports auto-completion)

Flags​

  • --project-id - Project ID (uses context if not specified)
  • --name - New name for the volume
  • --tags - New tags (comma-separated)

Note: At least one of --name or --tags must be provided.

Example​

# Update name only
acloud storage blockstorage update 69455aa70d0972656501d45d --name "prod-data-volume"

# Update tags only
acloud storage blockstorage update 69455aa70d0972656501d45d --tags "production,critical"

# Update both
acloud storage blockstorage update 69455aa70d0972656501d45d \
  --name "prod-data-volume" \
  --tags "production,critical"

Output​

Block storage updated successfully!
ID:              69455aa70d0972656501d45d
Name:            prod-data-volume
Tags:            [production critical]
Size (GB):       50
Type:            Standard

Delete Block Storage​

Delete a block storage volume. This action cannot be undone.

Usage​

acloud storage blockstorage delete <volume-id> [flags]

Arguments​

  • volume-id - The ID of the block storage volume (supports auto-completion)

Flags​

  • --project-id - Project ID (uses context if not specified)
  • -y, --yes - Skip confirmation prompt

Example​

# With confirmation prompt
acloud storage blockstorage delete 69455aa70d0972656501d45d

# Skip confirmation
acloud storage blockstorage delete 69455aa70d0972656501d45d --yes

Output​

Block storage 69455aa70d0972656501d45d deleted successfully!

Notes​

  • Block storage volumes can be created with different types (Standard or Performance)
  • Volumes must be detached from VMs before deletion
  • The zone is automatically assigned if not specified
  • Billing periods can be Hour, Month, or Year
  • Tags are useful for organizing and filtering resources