createBackup

async createBackup(
  options: BackupOptions
): Promise<DirectoryBackup>

import { getSandbox } from '@cloudflare/sandbox';

const sandbox = getSandbox(env.SANDBOX, 'my-sandbox');

// Create some files
await sandbox.writeFile('/workspace/data/output.txt', 'Results...');
await sandbox.writeFile('/workspace/data/analysis.json', JSON.stringify(data));

// Create a backup
const backup = await sandbox.createBackup({
  dir: '/workspace/data',
  name: 'analysis-results',
  ttl: 7 * 24 * 60 * 60 // 7 days
});

// Store backup handle for later restoration
await env.KV.put('backup:latest', JSON.stringify(backup));
console.log('Backup created:', backup.id);

// Save work-in-progress
const checkpoint = await sandbox.createBackup({
  dir: '/workspace',
  name: 'checkpoint-before-experiment'
});

try {
  // Try something risky
  await sandbox.exec('rm -rf /workspace/old-data');
  await sandbox.exec('experimental-script.sh');
} catch (error) {
  // Restore if it fails
  console.log('Experiment failed, restoring checkpoint...');
  await sandbox.restoreBackup(checkpoint);
}

// Create daily backups with cleanup
const backup = await sandbox.createBackup({
  dir: '/workspace/important',
  name: `backup-${new Date().toISOString().split('T')[0]}`,
  ttl: 30 * 24 * 60 * 60 // Keep for 30 days
});

// Store in Durable Object or KV
await env.KV.put(
  `backup:${backup.id}`,
  JSON.stringify(backup),
  { expirationTtl: 30 * 24 * 60 * 60 }
);

# wrangler.toml
[[r2_buckets]]
binding = "BACKUP_BUCKET"
bucket_name = "my-backups"

[env.production]
[env.production.vars]
CLOUDFLARE_ACCOUNT_ID = "your-account-id"
R2_ACCESS_KEY_ID = "your-access-key"
R2_SECRET_ACCESS_KEY = "your-secret-key"
BACKUP_BUCKET_NAME = "my-backups"

try {
  const backup = await sandbox.createBackup({
    dir: '/workspace/data'
  });
} catch (error) {
  if (error.code === 'BACKUP_CREATE_ERROR') {
    console.error('Failed to create backup:', error.message);
  }
}