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

# Gestionar archivos de Blob Storage desde la CLI

> Lista, sube, elimina y enlaza los archivos de tu Blob Storage de Square Cloud con squarecloud blob, y comprueba cuánto del almacenamiento de tu plan usas.

`squarecloud blob` gestiona los archivos de tu [Blob Storage](https://docs.squarecloud.app/es/services/blob.md). Un archivo se identifica por su ID, que muestran `blob list` y `blob upload`.

Los comandos necesitan una API key con los [scopes](https://docs.squarecloud.app/es/blob-reference/authentication.md#scopes) `blob:read` y `blob:write`. El inicio de sesión por navegador pide ambos. Una clave de un inicio de sesión por navegador anterior a la versión 3.2.0 no los tiene: el primer comando de Blob te pide entonces que vuelvas a ejecutar `squarecloud auth login`. Una clave en `SQUARECLOUD_API_KEY` también necesita ambos scopes.

## `squarecloud blob list`

```bash Uso theme={"system"}
squarecloud blob list [prefix] [--json]
```

Muestra el ID, el tamaño, la fecha de creación y la URL de cada archivo, o solo de los archivos bajo `prefix`. Un archivo privado muestra `(private)` en lugar de una URL.

```bash theme={"system"}
squarecloud blob list avatars/
# Solo los archivos bajo avatars/.
```

Con `--json`, muestra los archivos como un array JSON.

## `squarecloud blob upload`

```bash Uso theme={"system"}
squarecloud blob upload <file> [--name <name>] [--private] [--json]
```

| Flag | Descripción |
| - | - |
| `--name <name>` | Guarda el archivo con este nombre, sin la extensión. Por defecto, el nombre es el del archivo sin su extensión. |
| `--private` | Guarda el archivo como privado: no tiene URL pública y solo se puede acceder a él mediante enlaces temporales. |

Sube un archivo y muestra su ID y su URL. El servicio conserva la extensión del archivo. En el nombre por defecto, los caracteres que el servicio no acepta se reemplazan por `_`. Para enviar una carpeta, comprímela primero con [`squarecloud zip`](https://docs.squarecloud.app/es/cli-reference/deploy#squarecloud-zip).

```bash theme={"system"}
squarecloud blob upload ./video.mp4
```

```bash Salida theme={"system"}
Uploading video.mp4 (1.20 GB)...
Sent part 77 of 77
✓ Uploaded as <ID>
  <URL>
```

* **Archivos grandes:** un archivo de más de 90 MiB se sube por partes, de seis en seis, con un tamaño calculado a partir de los límites que envía el servicio. El progreso va a stderr, así que stdout solo lleva el resultado.
* **Fallos:** una subida fallida o cancelada (`Ctrl+C`) se aborta, para que no ocupe uno de tus huecos de subidas abiertas. Solo se reintentan las lecturas y las partes, nunca un límite de tasa.
* **Archivos privados:** en lugar de una URL, la CLI muestra el comando que genera un enlace temporal, [`blob url`](#squarecloud-blob-url).

Con `--json`, stdout solo lleva el archivo guardado (ID, visibilidad, URL y tamaño, además del número de partes en una subida por partes) como JSON.

## `squarecloud blob url`

```bash Uso theme={"system"}
squarecloud blob url <id> [--json]
```

Muestra un enlace de descarga para un archivo: su URL pública, o un enlace temporal para un archivo privado. Solo el enlace va a stdout, así que funciona dentro de `$(...)`. Para un enlace temporal, la CLI indica en stderr hasta cuándo es válido.

```bash theme={"system"}
curl -o report.pdf "$(squarecloud blob url <ID>)"
# Descarga un archivo, público o privado.
```

Con `--json`, muestra el enlace con su expiración, su visibilidad, su tamaño y su tipo de contenido.

## `squarecloud blob delete`

```bash Uso theme={"system"}
squarecloud blob delete <id> [-y]
```

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

> [!WARNING]
>
> Eliminar un archivo es permanente: no hay papelera.

Pregunta `Delete <ID> for good? There is no trash [y/N]` antes de eliminar. `delete` no tiene salida JSON.

## `squarecloud blob stats`

```bash Uso theme={"system"}
squarecloud blob stats [--json]
```

Muestra cuántos archivos guardas y cuánto del almacenamiento de tu plan usan.

```bash Salida theme={"system"}
Files: <count>
Storage: <used> used of the <included> in your plan
```

Con `--json`, muestra tu registro de uso completo como JSON.

## Relacionado

| Comando | API | SDK de Blob |
| - | - | - |
| `list` | [`GET /v1/objects`](https://docs.squarecloud.app/es/blob-reference/endpoint/list) | [`blob.list()`](https://docs.squarecloud.app/es/sdks/blob/objects#listar) |
| `upload` | [`POST /v1/objects`](https://docs.squarecloud.app/es/blob-reference/endpoint/post), [subida por partes](https://docs.squarecloud.app/es/blob-reference/endpoint/chunked-init.md) | [`blob.put()`](https://docs.squarecloud.app/es/sdks/blob/uploads) |
| `url` | [`GET /v1/objects/download`](https://docs.squarecloud.app/es/blob-reference/endpoint/download) | [`blob.downloadUrl()`](https://docs.squarecloud.app/es/sdks/blob/objects#enlaces-de-descarga) |
| `delete` | [`DELETE /v1/objects`](https://docs.squarecloud.app/es/blob-reference/endpoint/delete) | [`blob.delete()`](https://docs.squarecloud.app/es/sdks/blob/objects#eliminar) |
| `stats` | [`GET /v1/account/stats`](https://docs.squarecloud.app/es/blob-reference/endpoint/stats) | [`blob.stats()`](https://docs.squarecloud.app/es/sdks/blob/rules_and_stats#estadísticas) |

Para usar Blob Storage desde tu propio código, empieza con el [SDK de Blob](https://docs.squarecloud.app/es/sdks/blob/client.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.