Barrack API Documentation
  1. backup
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
      POST
  • 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. backup

"Custom Images"

Custom images allow you to create reusable VM templates from your snapshots. These images can be used as boot sources when deploying new virtual machines, enabling you to quickly replicate configurations and software setups.
Custom images are created from your VM snapshots and serve as templates for new virtual machine deployments. They contain:
The complete operating system and all installed software
System configurations and settings
User data and applications
Custom scripts and automation

Creating Custom Images#

To create a custom image from a snapshot:
1.
Navigate to the Images page or access it from the snapshots interface
2.
Click "Create Image" in the Images section
3.
Select a snapshot from the available list (must have SUCCESS status)
4.
Enter a unique name for your image (1-50 characters)
5.
Optionally add a description to help identify the image's purpose
6.
Click "Create Image" to begin the creation process

Image Creation Requirements#

Source Snapshot: Must be in SUCCESS or available status
Name Requirements: 1-50 characters, letters, numbers, spaces, hyphens, underscores, periods
Uniqueness: Image names must be unique within your account
Region Specific: Images are created in the same region as the source snapshot

Using Custom Images#

Once created, custom images can be used when deploying new VMs:
1.
In the VM deployment wizard, select "Custom Images" as your boot source
2.
Choose your custom image from the dropdown list
3.
Images are filtered by the selected region automatically
4.
Complete the rest of your VM configuration and deploy

Custom Image Benefits#

Rapid Deployment: Skip manual software installation and configuration
Consistency: Ensure identical environments across multiple VMs
Team Collaboration: Share standardized environments with team members
Version Control: Create multiple image versions for different use cases

Managing Custom Images#

The Images page provides comprehensive management capabilities:

Image Information#

View image name, size, and creation date
Check image status and region information
Access detailed image properties and metadata
Monitor storage usage across all images

Image Operations#

Delete images that are no longer needed
View detailed image information and properties
Filter images by region for easier management
Track image creation from source snapshots

Image Status and Lifecycle#

Custom images go through different states during their lifecycle:
Available / SUCCESS: Image is ready to be used for VM deployment
Creating: Image is being created from the source snapshot

Region-Based Management#

Custom images are managed on a per-region basis:
Images are created in the same region as their source snapshot
Use the region dropdown to view images in different locations
Images can only be used to deploy VMs in their respective regions
Transfer between regions requires creating new snapshots and images

Common Use Cases#

Development Environment Templates#

Create standardized development environments with:
Pre-installed development tools and IDEs
Configured runtime environments (Python, Node.js, etc.)
Database servers and development dependencies
Custom scripts and shortcuts

Production Application Images#

Build production-ready images containing:
Production application code and dependencies
Optimized system configurations
Security hardening and monitoring tools
Load balancing and scaling configurations

Machine Learning Workloads#

Create ML-optimized images with:
Pre-installed ML frameworks (TensorFlow, PyTorch, etc.)
Jupyter notebooks and development environments
Pre-configured CUDA and GPU drivers
Common datasets and model libraries
Previous
"Creating Snapshots"
Next
"Managing Snapshots"
Built with