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

erforderlich

Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren Kontoeinstellungen.

Delete entfernt ein einzelnes gespeichertes Objekt anhand seines vollständigen Schlüssels, einschließlich des Konto-ID-Präfixes des Eigentümers. Es gibt kein Massenlöschen: Der Endpoint wirkt immer nur auf einen Namen, entnommen aus dem Feld object oder dem ersten Eintrag eines objects-Arrays (aus Gründen der Abwärtskompatibilität erhalten), sodass das Entfernen mehrerer Dateien einen Request pro Objekt erfordert. Das Rate Limit von 10 Anfragen pro 10 Sekunden ist genau darauf ausgelegt: Ein Mehrfachauswahl-Löschen von 20 Dateien dauert etwa 2 Sekunden. Der Objektschlüssel wird vor dem Löschen gegen die Konto-ID deines Tokens geprüft; ein Schlüssel, der außerhalb deines eigenen Präfixes aufgelöst wird, wird als INVALID_OBJECT abgelehnt, statt als kontoübergreifende Abfrage behandelt zu werden. Eine einzige Datenbankabfrage führt sowohl das Löschen aus als auch bestätigt, dass das Objekt existierte, sodass das Löschen eines bereits nicht mehr vorhandenen Namens OBJECT_NOT_FOUND zurückgibt. Um den genauen Objektschlüssel vor dem Löschen zu finden, liste deine Objekte mit Objektliste auf; um die Speichernutzung nach dem Aufräumen zu prüfen, siehe Account Stats.

string

erforderlich

Der Name des zu löschenden Objekts. Der Objektname muss folgendem Muster entsprechen: a to z, A to Z, 0 to 9, and _.

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

Antwort

string

Gibt an, ob der Aufruf erfolgreich war. “success” bei Erfolg, “error” bei Misserfolg.

{
  "status": "success"
}

Fehlerbehebung

Statuscode 400
Statuscode 401
Statuscode 404
Statuscode 429

Objektbezogen

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

Nicht autorisiert

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

Nicht gefunden

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

Rate-Limit erreicht

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

Zurück

Chunked InitDiese Dokumentation bietet einen umfassenden Überblick über den Endpoint POST /v1/objects/chunked der SquareCloud Blob API.

Weiter

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

Blob-Endpunkte

Chunked-Uploads

Antwort

Fehlerbehebung

Objektbezogen

Nicht autorisiert

Nicht gefunden

Rate-Limit erreicht

​Antwort

​Fehlerbehebung

​Objektbezogen

​Nicht autorisiert

​Nicht gefunden

​Rate-Limit erreicht

Antwort

Fehlerbehebung

Objektbezogen

Nicht autorisiert

Nicht gefunden

Rate-Limit erreicht