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

# Obter uso do armazenamento de blob e limites do plano

> Retorna o armazenamento usado, a cota do plano, a média do mês, as transformações de imagem usadas e os limites do plano.

Retorna quanto armazenamento de blob a conta usa, a sua cota, o excedente, se houver, e os `limits` do plano atual. Leia os limites aqui em vez de fixá-los no código: eles mudam com o plano. Os valores do exemplo são ilustrativos.

**Escopo:** `blob:read`.

**workspace\_id** `string`

O ID do workspace, quando o blob pertence a um workspace. A chamada atua sobre o blob do proprietário do workspace e exige a permissão `blob:read` do workspace (`blob:manage` nas rotas que alteram dados). Deixe de fora para atuar sobre o seu próprio blob.

### Exemplo de requisição

```bash theme={null}
curl "https://blob.vertracloud.app/v1/stats" \
  -H "Authorization: Bearer $VERTRA_API_KEY"
```

### Resposta

**response** `object`

Uso, cota e limites do plano.

**propriedades**

**objects** `number`

Número de objetos armazenados.

**used\_bytes** `number`

Bytes armazenados agora.

**quota\_bytes** `number`

Cota de blob do plano, em bytes.

**over\_quota\_bytes** `number`

Bytes acima da cota. Maior que 0 somente após um downgrade de plano.

**estimated\_overage\_cents** `number`

Cobrança estimada pelos bytes acima da cota, em centavos, cobrada na renovação: R\$0,20 por GB iniciado.

**month\_average\_bytes** `number`

Média de bytes armazenados no mês atual.

**image\_transformations\_used** `number`

Transformações de imagem usadas no mês atual.

**public\_base\_url** `string`

URL base dos arquivos públicos da conta.

**limits.max\_simple\_upload\_bytes** `number`

Maior arquivo aceito por `POST /v1/objects`. 100 MB em todos os planos.

**limits.max\_single\_put\_bytes** `number`

Maior arquivo que pode ser enviado em uma parte de um upload direto.

**limits.max\_object\_bytes** `number`

Maior objeto único, 10 GB.

**limits.min\_part\_bytes** `number`

Menor tamanho de parte permitido para uploads multipart.

**limits.max\_part\_bytes** `number`

Maior tamanho de parte permitido para uploads multipart.

**limits.max\_parts** `number`

Número máximo de partes que um upload multipart pode ter.

**limits.max\_open\_uploads** `number`

Quantos uploads diretos podem estar em andamento ao mesmo tempo no plano.

**limits.uploads\_per\_second** `number | null`

Uploads permitidos por segundo. `null` significa sem limite próprio (Enterprise-12 ou superior); abaixo disso, 1 por segundo.

**limits.max\_rules** `number`

Regras de pasta permitidas: 5, 10 ou 20, conforme o plano.

**limits.max\_custom\_domains** `number`

Domínios personalizados permitidos: 0, 1, 3 ou 10, conforme o plano.

**limits.metadata\_enabled** `boolean`

Se `metadata` pode ser definido (Enterprise-12 ou superior).

**limits.share\_password\_enabled** `boolean`

Se os links de compartilhamento podem ter senha (Enterprise-12 ou superior).

**limits.no\_cache\_enabled** `boolean`

Se `cache_control: "no-cache"` é permitido (Enterprise-26 ou superior).

**limits.min\_expiration\_seconds** `number`

Menor `expires_at` aceito, contado a partir de agora: 7 dias, ou 1 hora no Enterprise-26 ou superior.

**limits.image\_transformations\_per\_month** `number`

Transformações de imagem incluídas por mês. `0` no Economy e no Pro.

```json Response theme={null}
{
  "response": {
    "objects": 42,
    "used_bytes": 2147483648,
    "quota_bytes": 16106127360,
    "over_quota_bytes": 0,
    "estimated_overage_cents": 0,
    "month_average_bytes": 1932735283,
    "image_transformations_used": 120,
    "public_base_url": "https://blob.vertracloud.dev/k7p2m9x4qa",
    "limits": {
      "max_simple_upload_bytes": 104857600,
      "max_single_put_bytes": 104857600,
      "max_object_bytes": 10737418240,
      "min_part_bytes": 5242880,
      "max_part_bytes": 5368709120,
      "max_parts": 10000,
      "max_open_uploads": 4,
      "uploads_per_second": null,
      "max_rules": 10,
      "max_custom_domains": 3,
      "metadata_enabled": true,
      "share_password_enabled": true,
      "no_cache_enabled": false,
      "min_expiration_seconds": 604800,
      "image_transformations_per_month": 4000
    }
  }
}
```

### Respostas de erro

**code** `string`

O código de erro que indica o motivo da falha. Valores possíveis:

* `AUTH_TOKEN_MISSING` (`401`): o cabeçalho `Authorization` não foi enviado.
* `API_KEY_INVALID` (`401`): a chave de API não existe, foi revogada ou o segredo não confere.
* `API_KEY_SCOPE_DENIED` (`403`): a chave não tem o escopo que esta rota exige (`blob:read` ou `blob:write`); `details.required` informa qual.
* `WORKSPACE_PERMISSION_DENIED` (`403`): somente com `workspace_id`: você não é membro, ou o seu papel não tem a permissão de blob.
* `WORKSPACE_NOT_FOUND` (`404`): somente com `workspace_id`: não existe workspace com esse ID, ou você não é membro.

```json Error Response (401) theme={null}
{
  "code": "AUTH_TOKEN_MISSING"
}
```

```json Error Response (403) theme={null}
{
  "code": "API_KEY_SCOPE_DENIED"
}
```

```json Error Response (404) theme={null}
{
  "code": "WORKSPACE_NOT_FOUND"
}
```


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