Barrack API Documentation
  1. Volumes
Barrack API Documentation
  • Platform Documentation
    • Getting Started
    • Authentication & Access
    • Account Management
    • API Keys
    • GPU Models
    • Regions
    • Instance
      • OS Images
      • Bootsource Management
      • Deploy Instance
      • Instance Management
      • Hibernation
      • View Instances
    • SSH Keys
      • Add SSH Keys
      • Manage SSH Keys
    • Volumes
      • Overview
      • Create Volume
      • List and View Volumes
      • Attach Volumes
      • Detach Volumes
      • Clone Volumes
      • Resize Volume
      • Delete Volume
    • Advanced Configurations
      • Network And Security
      • Cloudinit Script
      • Startup Script
    • Firewall
      • Manage Firewall
      • Rules and Attachment
    • Snapshot
      • Overview
      • Manage Snapshots
      • Restore Snapshots
    • Custom Images
      • Overview
      • Create and Manage Images
    • dashboard
      • "Dashboard Overview"
      • "VM Management"
    • AI Chat
      • AI Chat
  • Balance
    • Get credit balance
      GET
  • GPU Stocks
    • Get GPU stock availability
      GET
  • GPU Specs
    • Get GPU specifications
      GET
  • Regions
    • List available regions
  • Pricing
    • Get pricing information
    • Get pricing information
  • Deploy Instance
    • Create a new instance
  • Instance management
    • List instances
    • Get instance details
    • Get instance billing
    • Start instance
    • Stop instance
    • Reboot instance
    • Hibernate instance
    • Restore hibernated instance
    • Toggle public IP for instance
    • Add instance security rule
    • Remove instance security rule
    • Delete instance
  • OS Images
    • List OS images
  • SSH Keys
    • List SSH keys
    • Get SSH key
    • Create SSH key
    • Delete SSH key
  • Volumes
    • List volumes
    • Create volume
    • Get volume details
    • Delete volume
    • Resize volume
    • Clone volume
    • Attach volumes to instance
    • Detach volumes from instance
    • List available volume types
    • Get volume billing
  • Firewalls
    • List firewalls
    • Get firewall details
    • Get supported protocols
    • Get firewalls attached to instance
    • List instances available for firewall attachment
    • Create firewall
    • Delete firewall
    • Add firewall rule
    • Remove firewall rule
    • Attach firewall to instances
  • Scripts
    • List all startup scripts
    • Get startup script details
    • Create a startup script
    • Update a startup script
    • Delete a startup script
    • Delete multiple startup scripts
  • Snapshots
    • List snapshots
    • Get snapshot details
    • List Instance eligible for snapshot creation
    • Get snapshot billing
    • Create snapshot
    • Delete snapshot
    • Restore snapshot
  • Images
    • List custom images
    • Get image details
    • Create image from snapshot
    • Delete custom image
    • Get snapshot-image relationship
    • Get snapshot-image relationship list
  • AI Chat
    • Get available AI models
    • Chat with AI
    • Get AI usage summary
    • Get AI usage history
  • Schemas
    • AITransaction
    • AddFirewallRuleRequest
    • AddFirewallRuleResponse
    • AddVMSecurityRuleResponse
    • AttachFirewallRequest
    • AggregatedBillingResponse
    • AttachFirewallResponse
    • AttachVolumesRequest
    • AttachVolumesResponse
    • AttachedFirewall
    • BatchSnapshotImageRelationshipResponse
    • Balance
    • Billing
    • ChatCompletionsRequest
    • ChatCompletionsResponse
    • CloneVolumeRequest
    • BillingRecord
    • CloneVolumeResponse
    • BillingSummary
    • CreateFirewallRequest
    • CreateFirewallResponse
    • CreateImageFromSnapshotRequest
    • CreateSSHKeyRequest
    • CreateScriptRequest
    • CreateSnapshotRequest
    • CreateSnapshotResponse
    • CreateSSHKeyResponse
    • CurrencyEnum
    • Data
    • CreditBalanceResponse
    • DeleteFirewallResponse
    • CreateVolumeRequest
    • DeleteSnapshotResponse
    • CreateVolumeResponse
    • DeleteVMResponse
    • DetachVolumesRequest
    • DetachVolumesResponse
    • DeploymentRequest
    • DirectionEnum
    • DeploymentResponse
    • EthertypeEnum
    • ErrorResponse
    • FirewallAttachment
    • DeleteVolumeResponse
    • DeleteSSHKeyResponse
    • FirewallEnvironment
    • FirewallResponse
    • FirewallRule
    • FirewallVM
    • GetBatchSnapshotImageRelationshipsRequest
    • GetFirewallDetailsResponse
    • GPUStockConfiguration
    • GPUSpec
    • GetHibernatedVMsResponse
    • GPUStockItem
    • GPUSpecsResponse
    • GetSupportedProtocolsResponse
    • GPUStocksResponse
    • GetVMAttachedFirewallsResponse
    • GetVolumeTypesResponse
    • HibernateVMResponse
    • HibernationBillingMetrics
    • ListFirewallsResponse
    • ListUserVMsResponse
    • ListVMsResponse
    • ModelsResponse
    • GetSSHKeysResponse
    • Pagination
    • PricingRequest
    • OSImage
    • PricingResponse
    • OSImagesResponse
    • Protocol
    • GpuCountEnum
    • ProtocolEnum
    • Image
    • GpuModelEnum
    • GetVolumeDetailsResponse
    • RebootVMResponse
    • ImageCreateResponse
    • RecentHibernation
    • ImageDeleteResponse
    • GetVolumesWithNextNameResponse
    • RemoveFirewallRuleResponse
    • ImageDetailResponse
    • RemoveVMSecurityRuleResponse
    • Region
    • ImageListResponse
    • ResizeVolumeRequest
    • RegionsResponse
    • Price
    • ResizeVolumeResponse
    • ResourceTypeEnum
    • RestoreSnapshotRequest
    • RestoreSnapshotResponse
    • RestoreVMResponse
    • Snapshot
    • SnapshotImageRelationshipResponse
    • Specs
    • StartVMResponse
    • StopVMResponse
    • TierEnum
    • UpdateScriptRequest
    • UsageHistoryResponse
    • UsageSummaryResponse
    • RegionEnum
    • UserVM
    • VMDetailsResponse
    • VMFlavor
    • VMImage
    • VMInstance
    • VMResponse
    • SpecsMetadata
    • VMSecurityRule
    • VMSecurityRuleRequest
    • VMStatus
    • VMVolumeAttachment
    • Script
    • VolumeTypeEnum
    • SSHKeyResponse
    • ScriptListResponse
    • ToggleVMPublicIPResponse
    • VolumeBillingRecord
    • VolumeBillingSummary
    • VolumeHourlyBillingResponse
    • VolumeResponse
  1. Volumes

Clone Volumes

Clone Volumes#

This guide covers cloning storage volumes to create exact copies with all data preserved. Cloning creates a new volume with identical data from the source volume.

Prerequisites#

Before cloning, ensure you meet the general volume prerequisites.
Clone-Specific Requirements:
Source volume in advanced tier region (FINLAND-1/2/3, ICELAND-1)
Volume status: Available OR Attached to SHUTOFF instance
Clone destination: Same region as source (cross-region not supported)
Unique name for clone within target region

Clone Configuration#

PropertyBehaviorOptions
NameRequired unique nameDefault: {source}-clone
Rules: 3-30 chars, alphanumeric + _-
SizeInherited from sourceCannot change during clone
Use resize after
Volume TypeSelectableKeep source type OR
Switch between NVMe/HDD
RegionSame as sourceCross-region not supported
BootableAlways non-bootableClones are data volumes only
Volume Type Selection
NVMe - High-performance NVMe storage ($0.30/GB/month)
Low latency, high IOPS
Best for databases and I/O intensive workloads
HDD - Cost-effective magnetic storage ($0.08/GB/month)
Higher latency, lower cost
Best for backups, archives, and sequential workloads
Choose based on your performance vs. cost requirements.

Cloning a Volume#

Step 1: Select Source Volume#

1
Navigate to Volumes Page
Go to barrack.ai/volumes
2
Select Region
Use region dropdown to filter volumes. Source volume must be in advanced tier region.
3
Locate Volume
Find the volume you want to clone. Click info icon (ℹ️) on volume card to view details.

Step 2: Verify Clone Eligibility#

Check source volume status and VM state:
Eligible Volumes:
Status: "Available" (detached)
Status: "Attached" with VM Status: "SHUTOFF"
Ineligible Volumes:
Attached to ACTIVE instance (shut down first)
Attached to CREATING/HIBERNATED instance
In CREATING state (wait for completion)
Located in legacy region CANADA-1 (not supported)

Step 3: Initiate Clone Operation#

In the volume details modal:
1.
Click "Clone" button in Advanced Operations section
2.
Clone modal opens with pre-filled information
Pre-filled Data:
Clone name: {source-volume-name}-clone
Size: Inherited from source (read-only)
Region: Source volume region (read-only)
Volume type: Source volume type (modifiable)

Step 4: Configure Clone Settings#

Clone Name:
Edit the suggested name if desired. Name must be:
Unique in target region
3-30 characters
Letters, numbers, hyphens, underscores only
Cannot start/end with hyphen or underscore
Volume Type:
Select volume type for clone:
Keep source type OR
Change to different type (NVMe/HDD)
Pricing Information:
Modal displays:
Per GB monthly rate for selected type
Total monthly cost based on volume size
Currency (USD/EUR/INR based on account)

Step 5: Confirm Clone#

Review configuration and click "Clone Volume" button.
Clone Process:
1.
System validates source volume status
2.
System checks instance state (if attached)
3.
System verifies sufficient credits
4.
System validates region restrictions
5.
System checks name uniqueness
6.
barrack creates volume clone
7.
New volume appears in volumes list
8.
Billing starts for cloned volume
Processing Time:
Clone operation typically completes within 2-5 minutes depending on volume size. Larger volumes take longer.

Step 6: Verify Clone#

After clone completes:
Volume List Updates:
New volume appears with clone name
Status shows "Available"
Size matches source volume
Selected volume type displayed
Same region as source
Clone Data:
All data from source volume preserved
Filesystem intact
Files accessible immediately after attachment

Validation#

View Pre-Clone Validation Checks
The system validates before proceeding:
Volume Checks:
Exists and belongs to your account
Status is Available or Attached to SHUTOFF instance
Located in advanced tier region (not CANADA-1)
Size within supported limits
Instance Validation (if attached):
Instance status is SHUTOFF
Not ACTIVE, CREATING, or HIBERNATED
Name & Region:
Clone name is unique in target region
Target region matches source region
Follows naming rules (3-30 chars, alphanumeric + _-)
Account Status:
Sufficient credits for cloned volume billing
Profile complete with minimum balance
Common validation errors are covered in Troubleshooting below.

Post-Clone Status#

After successful clone:

Cloned Volume#

Status:
Initially "Creating" during clone process
Changes to "Available" when ready
Ready for attachment to any instance
Properties:
Same size as source volume
Selected volume type (NVMe or HDD)
Non-bootable data volume
Same region as source
Data:
Complete copy of source volume data
All files and filesystem preserved
No data loss or corruption
Independent from source volume

Source Volume#

Unchanged:
Source volume status unchanged
Data remains intact
Still available for use
Can be cloned again if needed

Billing Impact#

Cloned Volume Billing:
Billing starts immediately after creation
Hourly rate based on size and type
Independent billing from source volume
Same rates as creating new volume
Source Volume Billing:
Continues unchanged
No impact from clone operation

Troubleshooting#

Clone-Specific Errors#

Error: Volume can only be cloned when available or attached to shut off VM
Error: Cross-region cloning not supported
Error: Cloning only supported for advanced tier regions
Clone Button Disabled

Common Errors#

For authentication, credits, profile, and session errors, see Common Volume Errors.

Pricing#

Cloned volumes use same pricing as new volumes:
Advanced Tier (NVMe):
$0.30/GB/month (USD)
€0.35/GB/month (EUR)
₹30.0/GB/month (INR)
Advanced Tier (HDD):
$0.08/GB/month (USD)
€0.10/GB/month (EUR)
₹8.0/GB/month (INR)
Billing:
Starts immediately after clone creation
Charged hourly based on monthly rate
Independent billing from source volume
Examples:
Clone 500GB NVMe volume:
Monthly cost: 500GB × 0.30=150/month
Hourly rate: 150÷730= 0.21/hour
Clone 2000GB HDD volume:
Monthly cost: 2000GB × 0.08=160/month
Hourly rate: 160÷730= 0.22/hour

Best Practices#

Cloning Best Practices
Before Cloning:
Verify source data is current and backed up
Ensure sufficient credits for new volume billing
Choose volume type (NVMe vs HDD) based on performance needs
Plan unique naming convention for clones
Shut down attached instance if required
During Clone:
Don't modify source volume during clone process
Don't delete source volume during clone process
Wait for completion (2-5 minutes typical)
Monitor account credits for new volume charges
After Clone:
Verify clone status shows "Available"
Test data accessibility after attachment
Verify all files present and accessible (ls -lah)
Check filesystem integrity (df -h)
Update documentation with clone details
Consider deleting source if no longer needed

Next Steps#

After cloning volumes:
1
Verify Clone
Check volume appears in volumes list with "Available" status and correct size/type.
2
Attach to Instance
Navigate to cloned volume, click "Attach", select target instance (SHUTOFF), and confirm.
See Attach Volumes for detailed instructions.
3
Mount in OS
Start instance, SSH in, identify device (lsblk), and mount volume (mount /dev/vdb /mnt/data).
See Attach Volumes - Instance Configuration for OS-level mounting.
4
Verify Data
Check all files present, verify filesystem integrity, and test file access.
5
Update Applications
Update application configurations to use new volume if replacing original.

Support#

Email Support
Contact support for clone assistance. Include source volume ID/name, clone name attempted, error messages received, request ID (if applicable), and region.
Resize Volumes
Increase cloned volume size after creation. Requirements: volume status Available or Attached, new size larger than current, and advanced tier region only.
Previous
Detach Volumes
Next
Resize Volume
Built with