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

obbligatorio

La chiave API del tuo account. Puoi trovarla nelle impostazioni del tuo account.

Account Stats restituisce un’istantanea dell’utilizzo del tuo Blob Storage: numero di oggetti, byte totali memorizzati, quanta parte dello spazio incluso nel tuo piano hai utilizzato e il costo stimato di ciò che supera tale limite (R$ 0,20 per ogni GiB iniziato). Usalo per costruire un indicatore di utilizzo o verificare il margine disponibile prima di un grande batch di upload. La risposta viene messa in cache per account per 1 minuto, ma un upload o un’eliminazione andati a buon fine invalidano immediatamente quella cache, quindi le tue stesse scritture compaiono subito anche se il TTL limita solo l’obsolescenza dovuta ad altre fonti. Le chiamate hanno un limite di frequenza di 20 richieste ogni 60 secondi, con blocco di 60 secondi al superamento. Per vedere quali oggetti compongono il tuo utilizzo, controlla Object List; per liberare spazio, usa Object Delete.

Lo stato si aggiorna ogni 1 minuto.

Risposta

string

Indica se la chiamata è andata a buon fine. “success” se riuscita, “error” in caso contrario.

object

Mostra Toggle object

object

number

Il numero totale di oggetti nel tuo account.

number

La dimensione totale di tutti gli oggetti nel tuo account, in byte.

object

number

La dimensione totale di archiviazione inclusa nel piano, in byte.

object

number

Lo spazio extra utilizzato, in byte.

number

Il costo stimato dello storage oltre la tua quota inclusa, in BRL (R$ 0,20 per ogni GiB iniziato).

number

Riservato al pricing per singolo oggetto; attualmente sempre 0.

number

Il costo totale stimato dell’eccedenza per l’account, in BRL.

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

Risoluzione dei problemi

Status Code 401
Status Code 429

Non autorizzato

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

Frequenza limitata

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

Object ListQuesta documentazione fornisce una panoramica completa dell'endpoint GET /v1/objects della SquareCloud Blob API.

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

Endpoint Blob

Upload a Blocchi

Risposta

Risoluzione dei problemi

Non autorizzato

Frequenza limitata

​Risposta

​Risoluzione dei problemi

​Non autorizzato

​Frequenza limitata

Risposta

Risoluzione dei problemi

Non autorizzato

Frequenza limitata