Consultar o uso do Blob Storage

GET

account

stats

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/account/stats' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "usage": {
      "objects": 1284,
      "storage": 3221225472
    },
    "plan": {
      "included": 5368709120
    },
    "billing": {
      "extraStorage": 0,
      "storagePrice": 0,
      "objectsPrice": 0,
      "totalEstimate": 0
    },
    "month": {
      "days": 24,
      "average_storage": 3006477107
    }
  }
}

string

obrigatório

A chave da API para sua conta. Você pode encontrá-la nas configurações da conta.

As Estatísticas da Conta retornam um retrato do seu uso do Blob Storage: número de arquivos, bytes armazenados, o armazenamento incluído no seu plano, o uso médio deste mês e o custo estimado de tudo que estiver além do armazenamento incluído (R$ 0,20 por GiB iniciado). Use-as para montar um medidor de uso ou verificar a folga antes de um grande lote de uploads. Exige o escopo blob:read. A resposta fica em cache por 1 minuto, e os seus próprios uploads e exclusões limpam esse cache, então eles aparecem na hora.

Limites de taxa

20 requisições por minuto, com bloqueio por um curto período acima disso (RATE_LIMITED, 429).

Resposta

string

“success” se bem-sucedida, “error” caso contrário.

object

Mostrar Alternar objeto

object

number

O número de arquivos na sua conta.

number

O tamanho total dos seus arquivos, em bytes.

object

number

O armazenamento incluído no seu plano, em bytes.

object

number

O armazenamento além da quantidade incluída, em bytes.

number

O custo estimado desse armazenamento, em BRL (R$ 0,20 por GiB iniciado).

number

Reservado para cobrança por arquivo; sempre 0.

number

A estimativa total, em BRL.

object

number

Quantos dias do mês atual (UTC) têm uma amostra de uso.

number

A média dessas amostras diárias, em bytes.

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/account/stats' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "usage": {
      "objects": 1284,
      "storage": 3221225472
    },
    "plan": {
      "included": 5368709120
    },
    "billing": {
      "extraStorage": 0,
      "storagePrice": 0,
      "objectsPrice": 0,
      "totalEstimate": 0
    },
    "month": {
      "days": 24,
      "average_storage": 3006477107
    }
  }
}

Erros

Código	HTTP	Quando
`RATE_LIMITED`	429	Mais de 20 requisições em um minuto.

Relacionados

SDK do Blob: blob.stats()

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/account/stats' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "usage": {
      "objects": 1284,
      "storage": 3221225472
    },
    "plan": {
      "included": 5368709120
    },
    "billing": {
      "extraStorage": 0,
      "storagePrice": 0,
      "objectsPrice": 0,
      "totalEstimate": 0
    },
    "month": {
      "days": 24,
      "average_storage": 3006477107
    }
  }
}

Primeiros passos

Objetos

Uploads em partes

Conta

Links de compartilhamento

S3

Consultar o uso do Blob Storage

Limites de taxa

Resposta

Erros

Relacionados

​Limites de taxa

​Resposta

​Erros

​Relacionados

Limites de taxa

Resposta

Erros

Relacionados