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
    • Billing
      • Credit Depletion & Resource Protection
    • SSH Keys
      • Add SSH Keys
      • Manage SSH Keys
      • Connecting to Your VM via SSH
    • 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
  • Balance
    • Get credit balance
      GET
  • Deploy Instance
    • Create a new instance
      POST
  • Pricing
    • Get pricing information
      GET
    • Get pricing information
      POST
  • Instances
    • List instances
    • Delete instance
    • Hibernate instance
    • Reboot instance
    • Restore hibernated instance
    • Start instance
    • Stop instance
    • Toggle public IP for instance
    • Get instance details
    • Get firewalls attached to instance
    • Add instance security rule
    • Remove instance security rule
    • Get instance billing
    • List Instance eligible for snapshot creation
  • SSH Keys
    • List SSH keys
    • Create SSH key
    • Get SSH key
    • Delete SSH key
  • Volumes
    • Attach volumes to instance
    • Detach volumes from instance
    • List volumes
    • Create volume
    • Get volume details
    • Delete volume
    • Clone volume
    • Resize volume
    • Get volume billing
    • List available volume types
  • Scripts
    • List all startup scripts
    • Create a startup script
    • Get startup script details
    • Update a startup script
    • Delete a startup script
    • Delete multiple startup scripts
  • Snapshots
    • Create snapshot
    • List snapshots
    • Get snapshot details
    • Delete snapshot
    • Restore snapshot
    • Get snapshot billing
  • Images
    • List custom images
    • Get image details
    • Delete custom image
    • List OS images
    • Create image from snapshot
    • Get snapshot-image relationship
    • Get snapshot-image relationship list
  • Firewalls
    • List firewalls
    • Get firewall details
    • Attach firewall to instances
    • Delete firewall
    • Remove firewall rule
    • Add firewall rule
    • Create firewall
    • List instances available for firewall attachment
    • Get supported protocols
  • GPU Stocks
    • Get GPU stock availability
  • GPU Specs
    • Get GPU specifications
  • Regions
    • List available regions
  • Schemas
    • AddFirewallRuleRequest
    • APIKeyResponse
    • AddFirewallRuleResponse
    • AddVMSecurityRuleResponse
    • AttachFirewallRequest
    • AggregatedBillingResponse
    • AttachFirewallResponse
    • AttachVolumesRequest
    • AttachVolumesResponse
    • AttachedFirewall
    • BatchSnapshotImageRelationshipResponse
    • Balance
    • Billing
    • ChatCompletionsRequest
    • ChatCompletionsResponse
    • CloneVolumeRequest
    • BillingRecord
    • BillingBreakdown
    • CloneVolumeResponse
    • BillingSummary
    • CreateFirewallRequest
    • CreateFirewallResponse
    • BootSourceEnum
    • CreateImageFromSnapshotRequest
    • BulkDeleteResponse
    • CreateSSHKeyRequest
    • CreateScriptRequest
    • CreateSnapshotRequest
    • CreateSnapshotResponse
    • CreateSSHKeyResponse
    • ComputeBilling
    • CurrencyEnum
    • Data
    • CreditBalanceResponse
    • CreateAPIKeyRequest
    • DeleteFirewallResponse
    • CreateVolumeRequest
    • CreateAPIKeyRequestTierEnum
    • DeleteSnapshotResponse
    • CreateVolumeResponse
    • CreateAPIKeyResponse
    • DeleteVMResponse
    • DetachVolumesRequest
    • DetachVolumesResponse
    • DeploymentRequest
    • DirectionEnum
    • DeploymentResponse
    • CreateSnapshotData
    • EthertypeEnum
    • ErrorResponse
    • FirewallAttachment
    • DeleteVolumeResponse
    • DeleteSSHKeyResponse
    • FirewallEnvironment
    • FirewallResponse
    • FirewallRule
    • FirewallVM
    • DataVolumeBilling
    • GetBatchSnapshotImageRelationshipsRequest
    • GetFirewallDetailsResponse
    • GPUStockConfiguration
    • GPUSpec
    • GetHibernatedVMsResponse
    • GPUStockItem
    • GPUSpecsResponse
    • GetSupportedProtocolsResponse
    • GPUStocksResponse
    • GetVMAttachedFirewallsResponse
    • DeploymentData
    • DeleteAPIKeyResponse
    • GetVolumeTypesResponse
    • HibernateVMResponse
    • HibernationBillingMetrics
    • ListFirewallsResponse
    • ListUserVMsResponse
    • ListVMsResponse
    • DeploymentDataStatusEnum
    • ModelsResponse
    • GetSSHKeysResponse
    • Pagination
    • PricingRequest
    • OSImage
    • Deposit
    • PricingResponse
    • OSImagesResponse
    • DepositStatusEnum
    • Protocol
    • GpuCountEnum
    • FirewallInstance
    • ProtocolEnum
    • Image
    • GpuModelEnum
    • GetVolumeDetailsResponse
    • RebootVMResponse
    • ImageCreateResponse
    • RecentHibernation
    • ImageDeleteResponse
    • GetVolumesWithNextNameResponse
    • RemoveFirewallRuleResponse
    • ImageDetailResponse
    • RemoveVMSecurityRuleResponse
    • Region
    • ImageListResponse
    • ResizeVolumeRequest
    • RegionsResponse
    • Price
    • ResizeVolumeResponse
    • ResourceTypeEnum
    • RestoreSnapshotRequest
    • RestoreSnapshotResponse
    • GetSSHKeyDetailResponse
    • RestoreVMResponse
    • Snapshot
    • SnapshotImageRelationshipResponse
    • GetSnapshotDetailsResponse
    • Specs
    • StartVMResponse
    • GpuBilling
    • StopVMResponse
    • TierEnum
    • UpdateScriptRequest
    • UsageHistoryResponse
    • UsageSummaryResponse
    • RegionEnum
    • UserVM
    • VMDetailsResponse
    • VMFlavor
    • InstanceFeatures
    • VMImage
    • InstanceSpecs
    • VMInstance
    • IpStatusEnum
    • VMResponse
    • SpecsMetadata
    • VMSecurityRule
    • VMSecurityRuleRequest
    • VMStatus
    • VMVolumeAttachment
    • Script
    • ListFirewallInstancesResponse
    • VolumeTypeEnum
    • SSHKeyResponse
    • ScriptListResponse
    • OsVolume
    • ListSnapshotsResponse
    • ListVMsForSnapshotResponse
    • ListAPIKeysResponse
    • PricingRequestVolumeTypeEnum
    • ToggleVMPublicIPResponse
    • PatchedDeposit
    • PatchedTransaction
    • PaymentMethodEnum
    • VolumeBillingRecord
    • VolumeBillingSummary
    • VolumeHourlyBillingResponse
    • SecurityRule
    • ScriptCreateResponse
    • RestoreSnapshotData
    • ScriptDeleteResponse
    • ScriptDetailResponse
    • VolumeResponse
    • ScriptUpdateResponse
    • StatusEnum
    • StorageBilling
    • SnapshotBillingRecord
    • SnapshotBillingResponse
    • SnapshotBillingSummary
    • SnapshotDetail
    • SnapshotListItem
    • SnapshotVMResponse
    • Tier528Enum
    • TokenObtainPair
    • TokenRefresh
    • Transaction
    • VolumeCreate
    • TransactionTypeEnum
    • VolumeCreateVolumeTypeEnum
    • VolumeRate
    • UserProfile
    • VMDetailVolumeAttachment
    • VMOperations
    • VMSpecs
    • VolumeTypeItem
    • VolumeTypesByTier
  1. Volumes

Resize Volume

Resize volumes to increase their storage capacity. Resizing expands an existing volume's size without data loss.

Prerequisites#

Before resizing, ensure you meet the general volume prerequisites.
Resize-Specific Requirements:
Volume in advanced tier region (FINLAND-1/2/3)
Volume status: Available OR Attached (can resize while in use)
New size must be larger than current size
New size must be at least 100 GB
Volume type cannot be changed during resize

Resize Configuration#

PropertyBehaviorLimits
Current SizeRead-only displayShows current provisioned size
New SizeMust be larger than current sizeMin: 100 GB or current + 1 GB (whichever is greater)
Max SizeVaries by typeNVMe: 10,000 GB
HDD: 16,000 GB
Volume TypeUnchangedNVMe stays NVMe, HDD stays HDD
RegionUnchangedCannot move regions

Resizing a Volume#

Step 1: Select Volume#

1
Navigate to Volumes
Go to barrack.ai/volumes
2
Select Region
Use region dropdown - volume must be in advanced tier
3
Open Volume Details
Click info icon (ℹ️) on volume card

Step 2: Initiate Resize#

1.
Click "Resize" button in Advanced Operations section
2.
Resize modal opens showing:
Volume name (read-only)
Current size: {current_size} GB
Volume type badge (NVMe/HDD, read-only)
New size input field

Step 3: Configure New Size#

Enter New Size:
Type new size in GB. Use controls:
↑ Arrow: Increase by 100 GB
↓ Arrow: Decrease by 100 GB
Direct typing: Enter exact size
Size Requirements:
Must be a whole number (integers only, no decimals)
Must be at least 100 GB
Must exceed current size
Cannot exceed maximum for type (NVMe: 10,000 GB / HDD: 16,000 GB)
Visual Feedback:
Valid: Normal border
Invalid: Red border with error

Step 4: Review & Confirm#

Modal displays updated pricing:
Per TB hourly rate for volume type
Total hourly cost for new size
Currency based on account
Click "Resize Volume" to proceed.
Processing Time: 1-3 minutes typically

Step 5: Verify Resize#

After completion:
Size shows new value in volume list
Status unchanged (Available/Attached)
Billing reflects new size immediately
View Validation Checks
The system validates before proceeding:
Volume Checks:
Exists and belongs to your account
Status is Available or Attached (not Creating, Deleting, or Error)
Located in advanced tier region (FINLAND-1/2/3)
Size Validation:
New size ≥ 100 GB
New size > current size
New size ≤ maximum for type
Valid whole number (integer)
Account Status:
Sufficient credits for increased cost
Profile complete with minimum balance

Post-Resize Status#

Updated Properties:
Size reflects new value
Billing adjusted immediately
Capacity increased
Unchanged Properties:
Volume status (Available/Attached)
Volume type (NVMe/HDD)
Region, name, ID
Attached instance (if any)
All existing data preserved

Troubleshooting#

Resize-Specific Errors#

Error: New size must be larger than current size
Error: Volume size must be at least 100GB
Error: new_size must be a positive integer
Error: Size cannot exceed maximum
Error: Volume cannot be resized in current status
Error: Volume resize only supported for advanced tier regions
Resize Button Disabled

Common Errors#

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

Pricing#

Resized volumes use same per-TB hourly rates:
Advanced Tier Pricing:
TypeUSDEURINR
NVMe$0.30/TB/hr€0.35/TB/hr₹30/TB/hr
HDD$0.08/TB/hr€0.10/TB/hr₹8/TB/hr
Billing:
Immediate adjustment to new size
Charged hourly based on total new size in TB
Old size billing stops, new size starts
Examples:
500GB NVMe → 1000GB (USD):
Old: (500 / 1024) TB × $0.30/TB/hr = ~$0.1465/hr
New: (1000 / 1024) TB × $0.30/TB/hr = ~$0.2930/hr
Increase: +~$0.1465/hr

2000GB HDD → 5000GB (USD):
Old: (2000 / 1024) TB × $0.08/TB/hr = ~$0.1563/hr
New: (5000 / 1024) TB × $0.08/TB/hr = ~$0.3906/hr
Increase: +~$0.2344/hr
Resize Best Practices
Before Resizing:
Verify current usage and requirements
Calculate required new size
Ensure sufficient credits for increase
After Resizing:
Verify new size in volumes list
Confirm billing reflects new rate
Update documentation

Next Steps#

1
Verify Resize
Confirm size updated and status unchanged
2
Monitor Billing
Check credits reflect new rate

Support#

Email Support
Include: volume ID/name, current/attempted size, error messages, region
Clone Volumes
Create copy with different type. Advanced regions only.
Previous
Clone Volumes
Next
Delete Volume
Built with