Blob Account Stats

GET

account

stats

Blob Account Stats

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

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://blob.squarecloud.app/v1/account/stats', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://blob.squarecloud.app/v1/account/stats",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://blob.squarecloud.app/v1/account/stats"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://blob.squarecloud.app/v1/account/stats")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "response": {
    "usage": {
      "objects": 0,
      "storage": 0
    },
    "plan": {
      "included": 0
    },
    "billing": {
      "extraStorage": 0,
      "storagePrice": 0,
      "objectsPrice": 0,
      "totalEstimate": 0
    }
  }
}

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 objetos, bytes totales almacenados, cuánto has usado del almacenamiento incluido en tu plan, y el costo estimado de lo que exceda esa asignación (R$ 0.20 por GiB iniciado). Úsalo para construir un medidor de uso o comprobar el margen disponible antes de una subida masiva. La respuesta se almacena en caché por cuenta durante 1 minuto, pero una subida o eliminación exitosa invalida esa caché de inmediato, así que tus propios cambios se reflejan al instante aunque el TTL limite la desactualización proveniente de otras fuentes. Las llamadas están limitadas a 20 solicitudes cada 60 segundos, y se bloquean durante 60 segundos al superarlo. Para ver qué objetos componen tu uso, consulta Object List; para liberar espacio, usa Object Delete.

El estado se actualiza cada 1 minuto.

Respuesta

string

Indica si la llamada fue exitosa. “success” si tuvo éxito, “error” si no.

object

Mostrar Alternar objeto

object

number

El número total de objetos en tu cuenta.

number

El tamaño total de todos los objetos en tu cuenta, en bytes.

object

number

El tamaño total de almacenamiento incluido en el plan, en bytes.

object

number

El espacio adicional utilizado, en bytes.

number

El costo estimado del almacenamiento que excede tu cuota incluida, en BRL (R$ 0.20 por GiB iniciado).

number

Reservado para precios por objeto; actualmente siempre 0.

number

El costo total estimado de excedente para la cuenta, en BRL.

{
  "status": "success",
  "response": {
    "usage": {
      "objects": 0,
      "storage": 0
    },
    "plan": {
      "included": 0
    },
    "billing": {
      "extraStorage": 0,
      "storagePrice": 0,
      "objectsPrice": 0,
      "totalEstimate": 0
    }
  }
}

Solución de problemas

Código de estado 401
Código de estado 429

No autorizado

// The API key is missing or invalid. Set a valid key in the Authorization header.
{
    "status": "error",
    "code": "ACCESS_DENIED"
}

Límite de tasa alcanzado

// Stats rate limit reached (20 requests per 60s window, blocked for 60s).
{
    "status": "error",
    "code": "RATE_LIMITED"
}

Object ListEsta documentación ofrece una descripción completa del endpoint GET /v1/objects de la API de SquareCloud Blob.

Blob Account Stats

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

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://blob.squarecloud.app/v1/account/stats', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://blob.squarecloud.app/v1/account/stats",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://blob.squarecloud.app/v1/account/stats"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://blob.squarecloud.app/v1/account/stats")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "response": {
    "usage": {
      "objects": 0,
      "storage": 0
    },
    "plan": {
      "included": 0
    },
    "billing": {
      "extraStorage": 0,
      "storagePrice": 0,
      "objectsPrice": 0,
      "totalEstimate": 0
    }
  }
}

Endpoints de Blob

Subida en Partes

Respuesta

Solución de problemas

No autorizado

Límite de tasa alcanzado

​Respuesta

​Solución de problemas

​No autorizado

​Límite de tasa alcanzado

Respuesta

Solución de problemas

No autorizado

Límite de tasa alcanzado