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

# Gerencie os arquivos do Blob Storage pela CLI

> Liste, envie, exclua e gere links dos arquivos do seu Blob Storage da Square Cloud com squarecloud blob, e veja quanto do armazenamento do seu plano você usa.

O `squarecloud blob` gerencia os arquivos do seu [Blob Storage](https://docs.squarecloud.app/pt-br/services/blob.md). Um arquivo é identificado pelo ID, que o `blob list` e o `blob upload` imprimem.

Os comandos precisam de uma chave de API com os [escopos](https://docs.squarecloud.app/pt-br/blob-reference/authentication.md#escopos) `blob:read` e `blob:write`. O login pelo navegador pede os dois. Uma chave de um login pelo navegador anterior à versão 3.2.0 não os tem: o primeiro comando do Blob então pede que você execute `squarecloud auth login` de novo. Uma chave na `SQUARECLOUD_API_KEY` também precisa dos dois escopos.

## `squarecloud blob list`

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

Imprime o ID, o tamanho, a data de criação e a URL de todos os arquivos, ou só dos arquivos sob `prefix`. Um arquivo privado mostra `(private)` no lugar da URL.

```bash theme={"system"}
squarecloud blob list avatars/
# Só os arquivos sob avatars/.
```

Com `--json`, imprime os arquivos como um array JSON.

## `squarecloud blob upload`

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

| Flag | Descrição |
| - | - |
| `--name <name>` | Armazena o arquivo com este nome, sem a extensão. Por padrão, o nome é o nome do arquivo sem a extensão. |
| `--private` | Armazena o arquivo como privado: ele não tem URL pública e só pode ser acessado por links temporários. |

Envia um arquivo e imprime o ID e a URL dele. O serviço mantém a extensão do arquivo. No nome padrão, os caracteres que o serviço não aceita são trocados por `_`. Para enviar uma pasta, compacte-a antes com o [`squarecloud zip`](https://docs.squarecloud.app/pt-br/cli-reference/deploy#squarecloud-zip).

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

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

* **Arquivos grandes:** um arquivo acima de 90 MiB é enviado em partes, seis por vez, com o tamanho definido pelos limites que o serviço envia. O progresso vai para o stderr, então o stdout traz só o resultado.
* **Falhas:** um upload que falha ou é cancelado (`Ctrl+C`) é abortado, para não ocupar uma das suas vagas de upload aberto. Só leituras e partes são repetidas, nunca um rate limit.
* **Arquivos privados:** no lugar da URL, a CLI mostra o comando que gera um link temporário, o [`blob url`](#squarecloud-blob-url).

Com `--json`, o stdout traz só o arquivo armazenado (ID, visibilidade, URL e tamanho, além do número de partes em um upload em partes) em JSON.

## `squarecloud blob url`

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

Imprime um link de download para um arquivo: a URL pública dele, ou um link temporário para um arquivo privado. Só o link vai para o stdout, então ele funciona dentro de `$(...)`. Para um link temporário, a CLI informa no stderr até quando ele vale.

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

Com `--json`, imprime o link com a expiração, a visibilidade, o tamanho e o tipo de conteúdo.

## `squarecloud blob delete`

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

| Flag | Descrição |
| - | - |
| `-y`, `--yes` | Pula a confirmação. |

> [!WARNING]
>
> Excluir um arquivo é permanente: não há lixeira.

Pergunta `Delete <ID> for good? There is no trash [y/N]` antes de excluir. O `delete` não tem saída em JSON.

## `squarecloud blob stats`

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

Mostra quantos arquivos você armazena e quanto do armazenamento do seu plano eles usam.

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

Com `--json`, imprime o registro completo do seu uso em JSON.

## Relacionados

| Comando | API | SDK do Blob |
| - | - | - |
| `list` | [`GET /v1/objects`](https://docs.squarecloud.app/pt-br/blob-reference/endpoint/list) | [`blob.list()`](https://docs.squarecloud.app/pt-br/sdks/blob/objects#listagem) |
| `upload` | [`POST /v1/objects`](https://docs.squarecloud.app/pt-br/blob-reference/endpoint/post), [upload em partes](https://docs.squarecloud.app/pt-br/blob-reference/endpoint/chunked-init.md) | [`blob.put()`](https://docs.squarecloud.app/pt-br/sdks/blob/uploads) |
| `url` | [`GET /v1/objects/download`](https://docs.squarecloud.app/pt-br/blob-reference/endpoint/download) | [`blob.downloadUrl()`](https://docs.squarecloud.app/pt-br/sdks/blob/objects#links-de-download) |
| `delete` | [`DELETE /v1/objects`](https://docs.squarecloud.app/pt-br/blob-reference/endpoint/delete) | [`blob.delete()`](https://docs.squarecloud.app/pt-br/sdks/blob/objects#excluindo) |
| `stats` | [`GET /v1/account/stats`](https://docs.squarecloud.app/pt-br/blob-reference/endpoint/stats) | [`blob.stats()`](https://docs.squarecloud.app/pt-br/sdks/blob/rules_and_stats#estatísticas) |

Para usar o Blob Storage no seu próprio código, comece pelo [SDK do Blob](https://docs.squarecloud.app/pt-br/sdks/blob/client.md).


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