Barrack API Documentation
  1. vm
Barrack API Documentation
  • Platform Documentation
    • "Authentication & Access"
    • "Getting Started"
    • "Platform Documentation"
    • "Troubleshooting"
    • vm
      • "Advanced Configuration"
      • "Boot Source Configuration"
      • "GPU Configuration"
      • "Region Selection"
      • "SSH Key Configuration"
      • "VM States & Billing"
    • storage
      • "Managing Volumes"
      • "Storage Management"
    • ssh
      • "Creating SSH Keys"
      • "Importing SSH Keys"
      • "Managing SSH Keys"
    • security
      • "Attaching Firewalls to VMs"
      • "Firewall Management"
      • "Firewall Rules"
    • dashboard
      • "Dashboard Overview"
      • "VM Management"
    • backup
      • "Creating Snapshots"
      • "Custom Images"
      • "Managing Snapshots"
      • "Restoring Snapshots"
      • "Snapshots Management"
    • account
      • "Credits System"
      • "Account Management"
  • Balance
    • Get credit balance
      GET
  • GPU Stocks
    • Get GPU stock availability
      GET
  • GPU Specs
    • Get GPU specifications
      GET
  • Regions
    • List available regions
      GET
  • Pricing
    • Get pricing information
      GET
    • Get pricing information
      POST
  • Deploy Instance
    • Create a new instance
  • Instance management
    • List instances
    • Delete instance
    • Get instance billing
    • Hibernate instance
    • Reboot instance
    • Restore hibernated instance
    • Start instance
    • Stop instance
    • Toggle public IP for instance
    • Get instance details
    • Get hibernated instances count
    • Add instance security rule
    • Remove instance security rule
  • OS Images
    • List OS images
  • SSH Keys
    • List SSH keys
    • Create SSH key
    • Get SSH key
    • Delete SSH key
  • 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
  • Firewalls
    • List firewalls
    • Get firewall details
    • Attach firewall to instances
    • Get firewalls attached to instance
    • Delete firewall
    • Remove firewall rule
    • Add firewall rule
    • Create firewall
    • Get supported protocols
    • List instances available for firewall attachment
    • List instances available for firewall attachment
  • Snapshots
    • List snapshots
    • Get snapshot billing
    • List Instance eligible for snapshot creation
    • Get snapshot details
    • Delete snapshot
    • Restore snapshot
    • Create snapshot
    • Create snapshot
    • Get snapshot billing
  • Images
    • List custom images
    • Get image details
    • Delete custom image
    • Create image from snapshot
    • Get snapshot-image relationship
    • Get snapshot-image relationship list
  • AI Chat
    • Chat with AI
    • Get AI usage summary
    • Get AI usage history
    • Get available AI models
  • Volumes
    • Attach volumes to instance
    • Detach volumes from instance
    • Clone volume
    • Resize volume
    • Get volume billing
    • List available volume types
    • List volumes
    • Create volume
    • Get volume details
    • Delete volume
  • Virtual Machines
    • Get firewalls attached to instance
    • Remove instance security rule
    • List Instance eligible for snapshot creation
  • 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. vm

"Region Selection"

Choose the geographic location for your virtual machine deployment to optimize performance and compliance.
Select from our high-performance data centers around the world:
NORWAY-1
Europe Region
Location: Norway, Europe
Available GPU Types: All GPUs Available
Best For: European users, GDPR compliance
Latency: Optimized for European traffic
CANADA-1
North America Region
Location: Canada, North America
Available GPU Types: All GPUs Available
Best For: North American users
Latency: Low latency for Canadian and northern US users
US-1
United States Region
Location: United States
Available GPU Types: All GPUs Available
Best For: US-based users and applications
Latency: Optimized for US traffic

Regional Specifications#

RegionLocationGPU AvailabilityNetworkCompliance
NORWAY-1EuropeAll GPU typesHigh-speed European networkGDPR compliant
CANADA-1North AmericaAll GPU typesNorth American backbonePrivacy-focused
US-1United StatesAll GPU typesUS domestic networkUS data residency

GPU Availability by Region#

All regions support the complete range of GPU types:
H100 Series
A100 Series
Professional GPUs
Available in All Regions
H100-SXM5-80GB
H100-PCIe-NVLink-80GB
H100-PCIe-80GB
Regional Notes:
High demand GPU types
Availability varies by time and region
Check real-time availability during deployment

Region Selection Factors#

Performance Considerations#

Latency Optimization
Network Performance
Resource Availability

Compliance and Legal#

Data Residency
Geographic Data Requirements
GDPR Compliance: NORWAY-1 for European data
US Data Laws: US-1 for US-specific requirements
Cross-border Restrictions: Consider data transfer regulations
Industry Compliance: Healthcare, finance sector requirements
Privacy Regulations
Regional Privacy Laws
European GDPR: Strict data protection in NORWAY-1
Canadian PIPEDA: Privacy protection in CANADA-1
US State Laws: Various state-specific regulations in US-1
International Transfers: Consider data flow implications

Regional Pricing#

Pricing is consistent across all regions for the same GPU types:

Currency by Region#

While pricing is uniform, billing currency is determined by your account country setting:
USD Billing
EUR Billing
INR Billing
US Dollar Accounts
Most countries default to USD
Consistent pricing across regions
Standard international currency

Storage and Volume Considerations#

Regional Storage#

Volume Management by Region#

1
Plan Storage Strategy
Choose primary region for most workloads
Consider data gravity and access patterns
Plan for disaster recovery needs
Evaluate cross-region backup requirements
2
Create Regional Resources
Create volumes in the same region as VMs
Establish snapshots for backup and recovery
Set up cross-region replication if needed
Monitor regional storage usage
3
Optimize Access Patterns
Keep data close to compute resources
Minimize cross-region data transfers
Use local storage for temporary data
Plan for regional failover scenarios

Network and Connectivity#

Regional Network Features#

NORWAY-1 Network
European Connectivity
Direct connections to major European internet exchanges
Low latency to UK, Germany, France
High-speed connections to Scandinavia
Optimized for European CDN access
CANADA-1 Network
North American Connectivity
Direct connections to Canadian internet infrastructure
Low latency to northern US regions
Optimized for cross-border North American traffic
Good connectivity to major US cities
US-1 Network
US Domestic Network
Direct connections to major US internet exchanges
Optimized for continental US traffic
Low latency to major metropolitan areas
High-speed connections to cloud providers

Internet Connectivity Performance#

Expected latency ranges from each region:
Source RegionTo EuropeTo North AmericaTo Asia-Pacific
NORWAY-110-50ms100-150ms200-300ms
CANADA-180-120ms20-80ms150-250ms
US-1100-150ms20-100ms150-250ms

Region Selection Best Practices#

Decision Framework#

1
Identify Primary Users
Determine geographic location of primary users
Consider time zones for interactive applications
Evaluate access patterns and usage times
Plan for global vs. regional applications
2
Assess Compliance Requirements
Review data residency requirements
Check industry-specific regulations
Evaluate privacy law implications
Consider cross-border data transfer restrictions
3
Evaluate Technical Requirements
Assess latency sensitivity of applications
Consider data transfer volumes
Evaluate integration with other services
Plan for disaster recovery needs
4
Test and Validate
Deploy test VMs in candidate regions
Measure actual performance characteristics
Test connectivity from user locations
Validate compliance and legal requirements

Multi-Region Strategy#

Regional Redundancy
Global Applications
Development vs. Production

Common Region Selection Scenarios#

European Business
North American Startup
Global SaaS
AI Research
NORWAY-1 Primary Choice
Use Case: EU-based company with European customers
Benefits:
GDPR compliance by default
Low latency for European users
Data residency in Europe
Integration with European services
Considerations:
Higher latency for non-European access
Plan for global expansion

Changing Regions#

Current Limitations#

Migration Strategies#

If you need to change regions after deployment:
1
Plan Migration
Create snapshots of current VMs
Export important data and configurations
Plan for service downtime
Prepare new region resources
2
Recreate in New Region
Deploy new VMs in target region
Create new storage volumes as needed
Restore data from backups
Reconfigure applications and services
3
Update Configurations
Update DNS and networking configurations
Test connectivity and performance
Update monitoring and logging
Validate application functionality
4
Cleanup Old Resources
Delete old VMs and volumes
Clean up networking configurations
Update documentation and procedures
Monitor for any remaining dependencies
Previous
"GPU Configuration"
Next
"SSH Key Configuration"
Built with