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

requis

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

Delete supprime un seul objet stocké à partir de sa clé complète, incluant le préfixe d’ID du compte propriétaire. Il n’existe pas de suppression en masse : l’endpoint n’agit que sur un seul nom, pris depuis le champ object ou la première entrée d’un tableau objects (conservé pour la rétrocompatibilité), donc supprimer plusieurs fichiers nécessite une requête par objet. La limite de débit de 10 requêtes par 10 secondes est dimensionnée exactement pour cela : une suppression multi-sélection de 20 fichiers prend environ 2 secondes. La clé de l’objet est validée par rapport à l’ID de compte de votre jeton avant que la suppression ne s’exécute ; une clé qui pointe en dehors de votre propre préfixe est rejetée avec INVALID_OBJECT plutôt que traitée comme une recherche inter-comptes. Une seule requête à la base de données effectue à la fois la suppression et confirme l’existence de l’objet, donc supprimer un nom déjà absent renvoie OBJECT_NOT_FOUND. Pour trouver la clé exacte de l’objet avant de le supprimer, listez vos objets avec Liste d’objets ; pour vérifier l’utilisation du stockage après le nettoyage, consultez Métriques.

string

requis

Le nom de l’objet à supprimer. Le nom de l’objet doit respecter le motif suivant : a to z, A to Z, 0 to 9, and _.

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

Réponse

string

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

{
  "status": "success"
}

Dépannage

Code de statut 400
Code de statut 401
Code de statut 404
Code de statut 429

Lié à l’objet

// 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 autorisé

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

Introuvable

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

Limite de débit atteinte

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

Chunked InitCette documentation fournit une vue d'ensemble complète de l'endpoint POST /v1/objects/chunked de l'API Blob de 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"
}

Endpoints Blob

Upload par Morceaux

Réponse

Dépannage

Lié à l’objet

Non autorisé

Introuvable

Limite de débit atteinte

​Réponse

​Dépannage

​Lié à l’objet

​Non autorisé

​Introuvable

​Limite de débit atteinte

Réponse

Dépannage

Lié à l’objet

Non autorisé

Introuvable

Limite de débit atteinte