Blob Delete Objects

DELETE

objects

Blob Delete Objects

curl --request DELETE \
  --url https://blob.squarecloud.app/v1/objects \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "object": "<string>"
}
'

import requests

url = "https://blob.squarecloud.app/v1/objects"

payload = { "object": "<string>" }
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({object: '<string>'})
};

fetch('https://blob.squarecloud.app/v1/objects', 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/objects",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => json_encode([
    'object' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://blob.squarecloud.app/v1/objects"

	payload := strings.NewReader("{\n  \"object\": \"<string>\"\n}")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://blob.squarecloud.app/v1/objects")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"object\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Delete.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"object\": \"<string>\"\n}"

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

{
  "status": "success"
}

string

obbligatorio

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

Delete rimuove un singolo oggetto memorizzato tramite la sua chiave completa, incluso il prefisso con l’ID dell’account proprietario. Non esiste un’eliminazione in blocco: l’endpoint agisce sempre su un solo nome, preso dal campo object o dal primo elemento di un array objects (mantenuto per retrocompatibilità), quindi rimuovere molti file richiede una richiesta per ogni oggetto. Il limite di frequenza di 10 richieste ogni 10 secondi è dimensionato esattamente per questo: un’eliminazione multi-selezione di 20 file richiede circa 2 secondi. La chiave dell’oggetto viene validata rispetto all’ID account del tuo token prima che l’eliminazione venga eseguita; una chiave che risolve al di fuori del tuo prefisso viene rifiutata come INVALID_OBJECT invece di essere trattata come una ricerca cross-tenant. Un’unica query al database esegue sia l’eliminazione sia la conferma dell’esistenza dell’oggetto, quindi eliminare un nome già assente restituisce OBJECT_NOT_FOUND. Per trovare la chiave esatta dell’oggetto prima di eliminarlo, elenca i tuoi oggetti con Object List; per verificare l’utilizzo dello spazio di archiviazione dopo la pulizia, vedi Account Stats.

string

obbligatorio

Il nome dell’oggetto da eliminare. Il nome dell’oggetto deve rispettare il seguente pattern: a to z, A to Z, 0 to 9, and _.

{ "object": "ID/prefix/name1_ltq7b2sw-de6241.jpeg" }

Risposta

string

Indica se la chiamata ha avuto successo. “success” in caso di successo, “error” in caso contrario.

{
  "status": "success"
}

Risoluzione dei problemi

Codice di stato 400
Codice di stato 401
Codice di stato 404
Codice di stato 429

Relativi all’oggetto

// The request body is missing or is not a valid JSON object.
{
    "status": "error",
    "code": "INVALID_BODY"
}

// The provided object key is invalid: it must start with your own account ID prefix and contain no path traversal.
{
    "status": "error",
    "code": "INVALID_OBJECT"
}

// The request to delete the objects failed. Please try again.
{
    "status": "error",
    "code": "DELETE_FAILED"
}

Non autorizzato

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

Non trovato

// The object you are trying to delete does not exist.
{
    "status": "error",
    "code": "OBJECT_NOT_FOUND"
}

Limite di frequenza

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

Chunked InitQuesta documentazione fornisce una panoramica completa dell'endpoint POST /v1/objects/chunked dell'API Blob di SquareCloud.

Blob Delete Objects

curl --request DELETE \
  --url https://blob.squarecloud.app/v1/objects \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "object": "<string>"
}
'

import requests

url = "https://blob.squarecloud.app/v1/objects"

payload = { "object": "<string>" }
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({object: '<string>'})
};

fetch('https://blob.squarecloud.app/v1/objects', 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/objects",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => json_encode([
    'object' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://blob.squarecloud.app/v1/objects"

	payload := strings.NewReader("{\n  \"object\": \"<string>\"\n}")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://blob.squarecloud.app/v1/objects")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"object\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Delete.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"object\": \"<string>\"\n}"

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

{
  "status": "success"
}

Endpoint Blob

Upload a Blocchi

Risposta

Risoluzione dei problemi

Relativi all’oggetto

Non autorizzato

Non trovato

Limite di frequenza

​Risposta

​Risoluzione dei problemi

​Relativi all’oggetto

​Non autorizzato

​Non trovato

​Limite di frequenza

Risposta

Risoluzione dei problemi

Relativi all’oggetto

Non autorizzato

Non trovato

Limite di frequenza