Barrack API Documentation
  1. Snapshot
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
      GET
  • Pricing
    • Get pricing information
      GET
    • Get pricing information
      POST
  • 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. Snapshot

Restore Snapshots

Restoring Snapshots#

Restore snapshots to create new instances with identical configurations. The restore operation deploys a new instance from snapshot data, preserving all settings and disk contents.

Account Requirements#

Before restoring snapshots, verify these requirements:
Profile Completion
Required Fields:
Complete at barrack.ai/account
Full name
Billing address
Postal code
Country
Minimum Balance
Credit Requirements:
Maintain minimum balance:
US Dollar: $1.00 minimum
Euro: €1.00 minimum
Indian Rupee: ₹100.00 minimum

Snapshot Requirements#

Snapshot Status
Region Compatibility
Layer 2 Validation

Restore Process#

1
Select Snapshot
Click Restore on the snapshot card
2
Review Snapshot Information
Restore modal displays complete snapshot details:
Snapshot name and storage size
Source instance name and region
Creation timestamp and current status
CPU, RAM, GPU, and disk configuration
3
Enter New Instance Name
Provide a unique name for the new instance
Length: 2-30 characters
Must be unique across your instances
See naming rules in Configuration Errors section
4
Confirm Restore
Click Restore Snapshot to begin deployment
What Happens:
New instance created from snapshot
Instance ID assigned (BRK-XXXXXXD format)
IP address allocation begins
Billing starts immediately
Instance boots into ACTIVE state
Full disk contents restored
5
Access New Instance
Navigate to Instances page to view the restored instance
Instance shows:
New instance ID and name you provided
IP address (pending → assigned)
Billing status: Active
Boot source: snapshot
Region: CANADA-1

Post-Restore Information#

What Gets Restored#

Preserved from snapshot:
Complete disk contents and file system
Instance configuration (CPU, RAM, GPU)
Storage capacity and disk type
Network configuration and SSH keys
Installed software and data
Operating system state
New for restored instance:
Instance ID (new BRK-XXXXXXD)
Instance name (you provide)
IP address (newly assigned)
Billing history (starts fresh)
Creation timestamp

Instance Configuration#

The restored instance inherits all specifications from the snapshot:
Compute Resources
Matches Original:
GPU Type: Identical to snapshot
GPU Count: Same as original
vCPUs: Identical allocation
RAM: Same memory capacity (GB)
Storage
Disk Configuration:
Storage GB: Matches snapshot size
Disk Type: Same as original
Data: Complete disk contents restored
File system: Preserved from snapshot

Billing Details#

Immediate Billing
Charges Begin:
Start time: Restore completion
Billing plan: per-minute
Currency: Matches your account
Rate: Based on instance specifications
Ongoing Costs
Billing Continues:
While instance is ACTIVE
Separate from snapshot storage costs
Deducted from account balance
Visible in billing history

Snapshot-Image Relationships#

Understanding how snapshots and images interact:
Image Creation
Image Benefits
Image Deletion Effects

Configuration Errors#

Duplicate Instance Name
Snapshot Not Available
Insufficient Credits
Profile Incomplete
Instance Not Found After Restore
Snapshot Deleted During Restore
Invalid Snapshot Status
Invalid Instance Name Format

Support Resources#

Email Support
Contact Support Team
Email: [email protected]
Include in your message:
Snapshot ID
Snapshot name
New instance name attempted
Error messages received
Steps already tried
Managing Snapshots
View and Manage Your Snapshots
Learn how to:
View snapshot details
Monitor storage costs
Delete unused snapshots
Organize your backups
Previous
Manage Snapshots
Next
Overview
Built with