Consultar el uso de 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

requerido

La clave de API de tu cuenta. Puedes encontrarla en la configuración de tu cuenta.

Account Stats devuelve una instantánea del uso de tu Blob Storage: número de archivos, bytes almacenados, el almacenamiento incluido en tu plan, el uso medio de este mes y el coste estimado de todo lo que esté por encima del almacenamiento incluido (R$ 0.20 por GiB iniciado). Úsalo para construir un medidor de uso o comprobar el margen disponible antes de un lote grande de subidas. Requiere el scope blob:read. La respuesta se guarda en caché durante 1 minuto, y tus propias subidas y eliminaciones limpian esa caché, así que aparecen de inmediato.

Límites de tasa

20 solicitudes por minuto; por encima de eso, bloqueo durante un breve periodo (RATE_LIMITED, 429).

Respuesta

string

“success” si tuvo éxito, “error” si no.

object

Mostrar Alternar objeto

object

number

El número de archivos de tu cuenta.

number

El tamaño total de tus archivos, en bytes.

object

number

El almacenamiento incluido en tu plan, en bytes.

object

number

El almacenamiento por encima de la cantidad incluida, en bytes.

number

El coste estimado de ese almacenamiento, en BRL (R$ 0.20 por GiB iniciado).

number

Reservado para precios por archivo; siempre 0.

number

La estimación total, en BRL.

object

number

Cuántos días del mes actual (UTC) tienen una muestra de uso.

number

La media de esas muestras diarias, en 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
    }
  }
}

Errores

Código	HTTP	Cuándo
`RATE_LIMITED`	429	Más de 20 solicitudes en un minuto.

Relacionado

SDK de 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
    }
  }
}

Primeros pasos

Objetos

Subidas por partes

Cuenta

Enlaces compartidos

S3

Consultar el uso de Blob Storage

Límites de tasa

Respuesta

Errores

Relacionado

​Límites de tasa

​Respuesta

​Errores

​Relacionado

Límites de tasa

Respuesta

Errores

Relacionado