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

Overview

Getting Started with Snapshots#

Snapshots are point-in-time copies of your instances, capturing the complete state including disk data, configuration, and system state. Use snapshots for backups, testing, or creating templates for future deployments.

Regional Availability#

Legacy Tier - CANADA-1
Snapshot Support: Available
Create unlimited snapshots
Point-in-time instance backups
Restore to new instances
Use as deployment templates
Full disk state preservation
Advanced Tier Regions
Snapshot Support: Not Available
FINLAND-1, FINLAND-2, FINLAND-3, ICELAND-1
Advanced tier regions do not currently support snapshot functionality. Contact support for backup options in advanced tier regions.

Account Requirements#

Before creating snapshots, ensure your account meets these requirements:
Profile Completion
Required Account Information
Complete your profile at barrack.ai/account
Required fields:
Full name
Billing address
Postal code
Country
Minimum Balance
Account Credit Requirements
Maintain minimum balance:
US Dollar: $1.00 minimum
Euro: €1.00 minimum
Indian Rupee: ₹100.00 minimum
Add credits before creating snapshots

Instance Requirements#

Instance Status
Active Instances Only
Instance must be in ACTIVE state
Powered-off or stopped instances cannot be snapshotted
Check instance status before creating snapshot
Only running instances appear in VM selection list
Supported Regions
Legacy Tier Only
Supported: CANADA-1
Not Supported: Advanced tier regions (Finland, Iceland)
Snapshots are only available for instances in legacy tier regions

Creating Your First Snapshot#

1
Navigate to Snapshots
Go to the Snapshots page from your dashboard navigation
2
Click Create Snapshot
Click the Create Snapshot button in the top right
3
Select Instance
Choose the instance to snapshot from the dropdown list
Available instances show:
Instance name
GPU type
Region
Only ACTIVE instances in CANADA-1 region appear in the list
4
Enter Snapshot Name
Provide a unique, descriptive name for your snapshot
Length: 2-30 characters
Must be unique across your snapshots
See detailed naming rules in the accordion below
5
Add Description (Optional)
Click Show advanced options to add a description
Maximum 500 characters
Helps identify snapshot purpose
Visible in snapshot details
6
Configure Options (Optional)
Advanced Options:
Create as Image
Enable to use snapshot as deployment template
Allows creating multiple instances from this snapshot
Recommended for repeatable deployments
7
Create Snapshot
Click Create Snapshot to start the process
What Happens:
Snapshot creation begins immediately
Billing starts upon successful creation
Status changes from "creating" to "available"
Original instance remains running and unaffected

Naming Guidelines#

Character Requirements
Format Rules
Character Limits
Best Practices

Configuration Errors#

Profile Incomplete
Insufficient Credits
Instance Not Active
Duplicate Snapshot Name
Invalid Snapshot Name Format
No Instances Available
VM Deleted During Creation
VM Status Changed
Advanced Region Error

Support Resources#

Email Support
Contact Support Team
Email: [email protected]
Include in your message:
Snapshot name (if applicable)
Instance name
Error messages received
Steps you've 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
Rules and Attachment
Next
Manage Snapshots
Built with