"Managing Volumes"

The Volumes page provides comprehensive tools for managing your storage, including attaching, detaching, and deleting volumes.

To attach a volume to a VM:

Select Volume

Click Attach on an available volume card

Review Volume Details

The Volume Attach Modal opens showing:

Volume details (name, size, region, type)

List of VMs in the same region with ACTIVE status

VM information (name, status, region) in a table format

Select Target VM

Select a VM using the radio button selection

Confirm Attachment

Click "Attach Volume" to confirm

Smart VM Filtering

Intelligent VM Selection

Only shows VMs in the same region as the volume

Filters by ACTIVE status for compatibility

Displays VM information clearly

Prevents incompatible attachments

Status Validation

Comprehensive Validation

Only ACTIVE VMs can be selected for attachment

Visual status indicators with color coding (green for ACTIVE)

Helpful messages explaining why non-ACTIVE VMs cannot be selected

Auto-selection of the first ACTIVE VM if available

Attachment Requirements

The system includes loading states that show progress during attachment operations, ensuring you have real-time feedback on the process.

Detaching Volumes

To detach a volume from a VM:

Initiate Detachment

Click Detach on an attached volume

Review Warning

A confirmation modal appears with volume details and warnings

Acknowledge Impact

Review the warning about potential application disruption

Confirm Detachment

Click "Detach" to confirm the operation

Smart Detachment System

The platform includes an intelligent detachment system:

Automatic Detection

Status Validation

Error Handling

VM Identification: System automatically finds the VM to detach from

Multi-source VM ID: Uses instance_id, attached volume mapping, or region-based VM search

Relationship Mapping: Tracks volume-VM relationships automatically

Detachment Requirements

VM Status

Active VM Required

VM must be in ACTIVE state for volume detachment

Cannot detach during VM state transitions

System validates VM availability before proceeding

System Volumes

Boot Volume Protection

Cannot detach the system/boot volume of a running VM

System identifies and protects critical volumes

Prevents accidental system disruption

Deleting Volumes

To delete a volume:

Ensure Detachment

Volume must be detached from all VMs first

Initiate Deletion

Click Delete on an unattached volume

Review Confirmation

A delete confirmation modal appears showing:

Volume name to be deleted

Warning that action cannot be undone

Permanent data loss warning

Confirm Deletion

Click "Delete" to confirm the permanent deletion

The deletion process includes comprehensive safeguards:

Safety Warnings

Process Protection

Deletion Requirements

Volume Status Indicators

Volumes display status indicators to show their current state:

Operational States

Transitional States

Volume Information Display

Each volume card displays comprehensive information:

Header Information

Volume Name: User-defined identifier with database icon

Status Badge: Current operational state with color coding

Attachment Info: Shows which VM the volume is attached to (if any)

VM Status: Displays the status of the attached VM for operational context

Specifications Grid

Size: Storage capacity in GB

Region: Geographic location (NORWAY-1, CANADA-1, US-1)

Type: Storage type (Cloud-SSD)

Bootable Status: Whether the volume can be used to boot VMs

Action Buttons

Dynamic buttons based on volume state:

Attach/Detach: Available based on current attachment status

Delete: Only available for unattached volumes

Storage Best Practices

Regional Planning

Capacity Management

Data Protection

Operational Efficiency

Volume Management Tips

Refresh and Data Management

Keep your volume data current:

Automatic Refresh: The page automatically refreshes after volume operations to show updated status

Loading States: Visual progress indicators show progress for create, attach, detach, and delete operations

Pagination Management: Pagination automatically adjusts when volumes are added or removed

Regional Filtering: Region filtering allows you to manage volumes across different geographic locations

Real-time Updates: Volume statistics update in real-time as you perform operations

Error Handling and Recovery

Attachment Failures

Detachment Issues

Deletion Problems

Common Issues and Solutions:

VM Not Active: Wait for VM to reach ACTIVE state before attaching

Region Mismatch: Ensure volume and VM are in the same region

Volume In Use: Check if volume is already attached to another VM

Insufficient Permissions: Verify account permissions and status

Integration with VM Workflow

Seamless Operations

Volume management integrates seamlessly with your VM workflow:

Live Management: Attach and detach volumes without VM downtime (for data volumes)

Performance Monitoring: Real-time status updates and performance metrics

Automated Detection: System automatically detects volume-VM relationships

Consistency Checks: Validates operations to prevent configuration conflicts

Workflow Examples

Development Environment

Create volumes for project data and dependencies

Attach volumes to development VMs as needed

Detach and reattach volumes to different VMs for testing

Delete temporary volumes when projects are complete

Production Deployment

Create bootable volumes with production configurations

Attach data volumes to production VMs for persistence

Implement backup strategies with regular snapshots

Manage volume lifecycle based on business requirements

Disaster Recovery

Create cross-region volume backups using snapshots

Test volume restoration procedures regularly

Document volume dependencies and relationships

Implement automated recovery workflows

Volume Attach Modal Features#

Attachment Requirements#

Detaching Volumes#

Smart Detachment System#

Detachment Requirements#

Deleting Volumes#

Delete Confirmation Modal#

Deletion Requirements#

Volume Status Indicators#

Volume Information Display#

Header Information#

Specifications Grid#

Action Buttons#

Storage Best Practices#

Volume Management Tips#

Refresh and Data Management#

Error Handling and Recovery#

Integration with VM Workflow#

Seamless Operations#

Workflow Examples#

Volume Attach Modal Features