Estatísticas da Conta Blob

GET

account

stats

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

import requests

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

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

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

}

HttpResponse<String> response = Unirest.get("https://blob.squarecloud.app/v1/account/stats")
  .header("Authorization", "<authorization>")
  .asString();

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

Authorization

string

obrigatório

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

Estatísticas da conta retorna um retrato do seu uso do Blob Storage: número de objetos, total de bytes armazenados, quanto do armazenamento incluído no seu plano já foi usado, e o custo estimado em USD de tudo que ultrapassa essa cota (US$ 0,25 por GiB adicional, arredondado para cima). Use para montar um medidor de uso ou verificar a folga disponível antes de um lote grande de uploads. A resposta fica em cache por conta durante 1 minuto, mas um upload ou uma exclusão bem-sucedidos invalidam esse cache imediatamente, então suas próprias mudanças aparecem na hora, mesmo que o TTL limite a desatualização vinda de outras fontes. As chamadas são limitadas a 20 requisições a cada 60 segundos, com bloqueio de 5 minutos ao exceder isso. Para ver quais objetos compõem seu uso, confira Lista de objetos; para liberar espaço, use Exclusão de objeto.

As estatísticas são atualizadas a cada 1 minuto.

Resposta

status

string

Indica se a chamada foi bem-sucedida. “success” se bem-sucedida, “error” caso contrário.

response

object

Mostrar Alternar objeto

usage

object

objects

number

O número total de objetos na sua conta.

storage

number

O tamanho total de todos os objetos na sua conta, em bytes.

plan

object

included

number

O tamanho total de armazenamento incluído no plano, em bytes.

billing

object

extraStorage

number

O espaço extra utilizado, em bytes.

storagePrice

number

O custo estimado do armazenamento além da sua cota incluída, em USD (US$ 0,25 por GiB adicional, arredondado para cima).

objectsPrice

number

Reservado para precificação por objeto; atualmente sempre 0.

totalEstimate

number

O custo total estimado de excedente para a conta, em USD.

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

Solução de problemas

401 Status Code
Código 429

Não autorizado

// A chave de API está ausente ou é inválida. Defina uma chave válida no cabeçalho Authorization.
{
    "status": "error",
    "code": "ACCESS_DENIED"
}

Limite de requisições

// Limite de stats atingido (20 requisições por janela de 60s).
{
    "status": "error",
    "code": "RATE_LIMITED"
}

Lista de ObjetosEsta documentação fornece uma visão abrangente do endpoint GET /v1/objects da API Blob da SquareCloud.

Estatísticas da Conta Blob

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

import requests

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

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

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

}

HttpResponse<String> response = Unirest.get("https://blob.squarecloud.app/v1/account/stats")
  .header("Authorization", "<authorization>")
  .asString();

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

​Resposta

​Solução de problemas

​Não autorizado

​Limite de requisições

Resposta

Solução de problemas

Não autorizado

Limite de requisições