---
title: "lizard volume"
description: "lizard volume crea, lista, redimensiona y elimina Persistent Volumes que los sandboxes conectan por nombre."
url: https://lizard.build/es/docs/cli/volume/
updated: 2026-10-10
---

# lizard volume

Gestiona [Persistent Volumes](https://lizard.build/es/docs/sandboxes/volumes.md) para sandboxes. Alias: `lizard vol`.

## Uso

```bash
lizard volume list [flags]
lizard volume create <name> [flags]
lizard volume resize <volume> --size <gb> [flags]
lizard volume rm <volume> [flags]
```

El nombre de un volumen es su clave dentro del proyecto. Todos los comandos aceptan un nombre o un ID, y `-p, --project` para apuntar a un proyecto distinto del vinculado.

## Subcomandos

### `lizard volume list`

Lista los volúmenes del proyecto con su tamaño, su estado y el sandbox al que están conectados (alias `ls`). `--json` incluye además los ID generados.

### `lizard volume create <name>`

Crea un volumen. Los nombres usan letras minúsculas, dígitos y guiones, empiezan y terminan con una letra o un dígito, tienen hasta 64 caracteres y son únicos en el proyecto.

| Bandera | Descripción |
|------|-------------|
| `--size <gb>` | Tamaño en GB enteros, de 1 a 50 (por defecto 5). La CLI lee primero los límites actuales del servidor |
| `--region <code>` | Región del volumen; debe coincidir con la del sandbox que lo conectará |
| `-p, --project <id>` | Nombre, slug o ID del proyecto |

### `lizard volume resize <volume> --size <gb>`

Cambia el tamaño de un volumen sin recrearlo. Un sandbox conectado sigue en ejecución y ve el nuevo tamaño. Un volumen Firecracker (el predeterminado) solo puede crecer. Un volumen respaldado por un pod también puede reducirse si al menos el 10 % del nuevo tamaño queda libre.

### `lizard volume rm <volume>`

Elimina un volumen y sus datos (alias `delete`). Falla mientras el volumen esté conectado; elimina antes el sandbox.

| Bandera | Descripción |
|------|-------------|
| `-y, --yes` | Omitir la confirmación |

El almacenamiento de volúmenes cuesta $0.14 por GB-mes de espacio usado. Consulta [Tamaño y precio](https://lizard.build/es/docs/sandboxes/volumes.md#size-and-price).

## Ejemplos

### Crear un volumen y conectarlo

```bash
lizard volume create agent-workdir --size 10
lizard sandbox create --volume agent-workdir
```

### Ampliar un volumen

```bash
lizard volume resize agent-workdir --size 20
```

### Eliminar un volumen

```bash
lizard volume rm agent-workdir --yes
```

## Véase también

- [Persistent Volumes](https://lizard.build/es/docs/sandboxes/volumes.md) — ciclo de vida, métodos del SDK y la vista del panel
- [lizard sandbox](https://lizard.build/es/docs/cli/sandbox.md) — conectar un volumen con `sandbox create --volume`
- [Almacenamiento y recuperación](https://lizard.build/es/docs/platform/storage-and-recovery.md) — qué pasa con los datos del volumen cuando falla un nodo