Statistiques du compte Blob

GET

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

requis

La clé d’API de votre compte. Vous pouvez la trouver dans les paramètres de votre compte.

Account Stats renvoie un instantané de votre utilisation du Blob Storage : nombre d’objets, octets totaux stockés, part de l’espace de stockage inclus dans votre plan que vous avez utilisée, et coût estimé pour tout dépassement de cette allocation (R$ 0,20 par GiB entamé). Utilisez-le pour construire un indicateur d’utilisation ou vérifier la marge disponible avant un lot important d’uploads. La réponse est mise en cache par compte pendant 1 minute, mais un upload ou une suppression réussi invalide ce cache immédiatement, donc vos propres écritures apparaissent tout de suite même si le TTL borne l’obsolescence pour les autres sources. Les appels sont limités à 20 requêtes par 60 secondes, avec un blocage de 60 secondes au-delà. Pour voir quels objets composent votre utilisation, consultez Liste d’objets ; pour libérer de l’espace, utilisez Suppression d’objets.

Le statut est mis à jour toutes les minutes.

Réponse

string

Indique si l’appel a réussi. “success” en cas de succès, “error” sinon.

object

Afficher Afficher l'objet

object

number

Le nombre total d’objets dans votre compte.

number

La taille totale de tous les objets de votre compte, en octets.

object

number

La taille de stockage totale incluse dans le plan, en octets.

object

number

L’espace supplémentaire utilisé, en octets.

number

Le coût estimé du stockage au-delà de votre quota inclus, en BRL (R$ 0,20 par GiB entamé).

number

Réservé à une future tarification par objet ; actuellement toujours 0.

number

Le coût total estimé de dépassement pour le compte, en BRL.

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

Dépannage

Code de statut 401
Code de statut 429

Non autorisé

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

Limite de débit atteinte

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

Liste d'objetsCette documentation fournit un aperçu complet de l'endpoint GET /v1/objects de l'API SquareCloud Blob.

Statistiques du compte Blob

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 Blob

Upload par Morceaux

Statistiques du compte Blob

Réponse

Dépannage

Non autorisé

Limite de débit atteinte

​Réponse

​Dépannage

​Non autorisé

​Limite de débit atteinte

Réponse

Dépannage

Non autorisé

Limite de débit atteinte