> ## 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.

# Crear y restaurar snapshots desde la CLI

> Crea, descarga, lista y restaura snapshots de aplicaciones y bases de datos de Square Cloud con squarecloud app snapshot y squarecloud db snapshot.

Un snapshot es una copia de seguridad de los archivos de una aplicación o de los datos de una base de datos. `squarecloud app snapshot` y `squarecloud db snapshot` funcionan igual: `create` crea uno, `list` muestra los guardados y `restore` recupera uno.

Para `create`, el ID de la app es opcional: consulta [cómo encuentra la CLI tu aplicación](/es/cli-reference/quickstart#cómo-encuentra-la-cli-tu-aplicación). El ID de la base de datos también es opcional: sin él, la CLI abre un selector con tus bases de datos.

## `squarecloud app snapshot create`

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

| Flag | Descripción |
| - | - |
| `--download` | Guarda el snapshot en la carpeta actual como `Square Cloud - Snapshot <date> <time>.zip` en lugar de mostrar un enlace de descarga. |

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

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

En una aplicación grande, el snapshot puede seguir generándose cuando el comando termina: la CLI lo indica, y el snapshot aparece en `snapshot list` en unos minutos. Una descarga se guarda de forma que solo tú puedes leerla (permisos 0600), y un `--download` fallido elimina el archivo parcial.

## `squarecloud app snapshot list`

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

Sin argumento, muestra una fila por cada snapshot de tus aplicaciones, con el ID del snapshot, cuántas versiones tiene, su tamaño total y la última actualización. Los IDs de snapshot recientes empiezan con el ID de la aplicación y terminan con etiquetas como `_javascript_manual`.

Pasa un ID de snapshot de esa lista para ver sus versiones y sus **IDs de versión**, que `restore` necesita:

```bash theme={"system"}
squarecloud app snapshot list <snapshotID>
# Una fila por versión: ID del snapshot, ID de la versión, tamaño y última actualización.
```

Con `--json`, la salida mantiene el mismo filtro. Listar snapshots requiere un plan activo.

## `squarecloud app snapshot restore`

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

| Flag | Descripción |
| - | - |
| `-y`, `--yes` | Omite la confirmación. |

Reemplaza los archivos actuales de la aplicación por una versión del snapshot. Toma `<snapshotID>` y `<versionID>` de [`app snapshot list`](#squarecloud-app-snapshot-list). Primero pide una confirmación `y/N`.

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

## `squarecloud db snapshot create`

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

| Flag | Descripción |
| - | - |
| `--download` | Guarda el snapshot en la carpeta actual como `Square Cloud - DB Snapshot <date> <time>.zip` en lugar de mostrar un enlace de descarga. |

Funciona como `app snapshot create`, pero para una base de datos.

## `squarecloud db snapshot list`

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

Sin argumento, una fila por cada snapshot de tus bases de datos. Con un ID de snapshot, una fila por versión, con los IDs de versión que recibe `restore`.

## `squarecloud db snapshot restore`

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

| Flag | Descripción |
| - | - |
| `-y`, `--yes` | Omite la confirmación. |

Reemplaza los datos actuales de la base de datos por una versión del snapshot, tras una confirmación `y/N`.

## Relacionado

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