> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Backup e ripristino con gli snapshot dalla CLI

> Crea, scarica, elenca e ripristina gli snapshot di applicazioni e database Square Cloud con squarecloud app snapshot e squarecloud db snapshot.

Uno snapshot è un backup dei file di un'applicazione o dei dati di un database. `squarecloud app snapshot` e `squarecloud db snapshot` funzionano allo stesso modo: `create` ne crea uno, `list` mostra quelli salvati, `restore` ne ripristina uno.

Per `create`, l'ID dell'app è facoltativo: vedi [come la CLI trova la tua app](/it/cli-reference/quickstart#come-la-cli-trova-la-tua-app). Anche l'ID del database è facoltativo: senza di esso, la CLI apre un selettore dei tuoi database.

## `squarecloud app snapshot create`

```bash Utilizzo theme={"system"}
squarecloud app snapshot create [appID] [--download]
```

| Flag | Descrizione |
| - | - |
| `--download` | Salva lo snapshot nella cartella corrente come `Square Cloud - Snapshot <date> <time>.zip` invece di stampare un link di download. |

```bash theme={"system"}
squarecloud app snapshot create --download
```

```bash Output theme={"system"}
✓ Your snapshot was created. Download it at:
  <download link>
```

Per un'applicazione di grandi dimensioni, lo snapshot può essere ancora in fase di generazione quando il comando termina: la CLI lo segnala, e lo snapshot compare in `snapshot list` entro pochi minuti. Un download viene salvato leggibile solo da te (permessi 0600), e un `--download` non riuscito rimuove il file parziale.

## `squarecloud app snapshot list`

```bash Utilizzo theme={"system"}
squarecloud app snapshot list [snapshotID] [--json]
```

Senza argomenti, stampa una riga per ogni snapshot delle tue applicazioni, con l'ID dello snapshot, quante versioni ha, la loro dimensione totale e l'ultimo aggiornamento. Gli ID degli snapshot recenti iniziano con l'ID dell'applicazione e terminano con tag come `_javascript_manual`.

Passa un ID di snapshot preso da quell'elenco per vederne le versioni e i relativi **ID di versione**, necessari a `restore`:

```bash theme={"system"}
squarecloud app snapshot list <snapshotID>
# Una riga per versione: ID dello snapshot, ID di versione, dimensione, ultimo aggiornamento.
```

Con `--json`, l'output mantiene lo stesso filtro. Per elencare gli snapshot serve un piano attivo.

## `squarecloud app snapshot restore`

```bash Utilizzo theme={"system"}
squarecloud app snapshot restore <appID> <snapshotID> <versionID> [-y]
```

| Flag | Descrizione |
| - | - |
| `-y`, `--yes` | Salta la richiesta di conferma. |

Sostituisce i file attuali dell'applicazione con una versione dello snapshot. Prendi `<snapshotID>` e `<versionID>` da [`app snapshot list`](#squarecloud-app-snapshot-list). Chiede prima una conferma `y/N`.

```bash Output theme={"system"}
✓ Restore started successfully
```

## `squarecloud db snapshot create`

```bash Utilizzo theme={"system"}
squarecloud db snapshot create [dbID] [--download]
```

| Flag | Descrizione |
| - | - |
| `--download` | Salva lo snapshot nella cartella corrente come `Square Cloud - DB Snapshot <date> <time>.zip` invece di stampare un link di download. |

Funziona come `app snapshot create`, per un database.

## `squarecloud db snapshot list`

```bash Utilizzo theme={"system"}
squarecloud db snapshot list [snapshotID] [--json]
```

Senza argomenti, una riga per ogni snapshot dei tuoi database. Con un ID di snapshot, una riga per versione, con gli ID di versione che accetta `restore`.

## `squarecloud db snapshot restore`

```bash Utilizzo theme={"system"}
squarecloud db snapshot restore <dbID> <snapshotID> <versionID> [-y]
```

| Flag | Descrizione |
| - | - |
| `-y`, `--yes` | Salta la richiesta di conferma. |

Sostituisce i dati attuali del database con una versione dello snapshot, dopo una conferma `y/N`.

## Correlati

| Comando | API | SDK JavaScript | VS Code |
| - | - | - | - |
| `app snapshot create` | [`POST .../snapshots`](/it/api-reference/endpoint/apps/snapshots/create) | [`api.apps.snapshots.create()`](/it/sdks/js/snapshots) | [Scarica snapshot](/it/vscode-extension/features#applicazioni) |
| `app snapshot list` | [`GET /v2/users/snapshots`](/it/api-reference/endpoint/users/snapshots) | [`api.account.snapshots()`](/it/sdks/js/client) | [Ripristina snapshot](/it/vscode-extension/features#applicazioni) |
| `app snapshot restore` | [`POST .../snapshots/restore`](/it/api-reference/endpoint/apps/snapshots/restore) | [`api.apps.snapshots.restore()`](/it/sdks/js/snapshots) | [Ripristina snapshot](/it/vscode-extension/features#applicazioni) |
| `db snapshot create` | [`POST .../snapshots`](/it/api-reference/endpoint/databases/snapshots/create) | [`api.databases.snapshots.create()`](/it/sdks/js/snapshots) | |
| `db snapshot list` | [`GET /v2/users/snapshots`](/it/api-reference/endpoint/users/snapshots) | [`api.account.snapshots()`](/it/sdks/js/client) | |
| `db snapshot restore` | [`POST .../snapshots/restore`](/it/api-reference/endpoint/databases/snapshots/restore) | [`api.databases.snapshots.restore()`](/it/sdks/js/snapshots) | |