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

requerido

La clave de API de tu cuenta. Puedes encontrarla en la configuración de tu cuenta.

Delete elimina un único objeto almacenado mediante su clave completa, incluido el prefijo de ID de la cuenta propietaria. No existe eliminación masiva: el endpoint siempre actúa sobre un solo nombre, tomado del campo object o de la primera entrada de un array objects (mantenido por compatibilidad con versiones anteriores), así que eliminar muchos archivos requiere una solicitud por objeto. El límite de tasa de 10 solicitudes cada 10 segundos está dimensionado exactamente para eso: una eliminación con selección múltiple de 20 archivos tarda unos 2 segundos. La clave del objeto se valida contra el ID de cuenta de tu token antes de ejecutar la eliminación; una clave que resuelve fuera de tu propio prefijo se rechaza como INVALID_OBJECT en lugar de tratarse como una búsqueda entre cuentas distintas. Una única consulta a la base de datos realiza la eliminación y confirma que el objeto existía, por lo que eliminar un nombre que ya no existe devuelve OBJECT_NOT_FOUND. Para encontrar la clave exacta del objeto antes de eliminarlo, lista tus objetos con Object List; para comprobar el uso de almacenamiento después de la limpieza, consulta Account Stats.

string

requerido

El nombre del objeto a eliminar. El nombre del objeto debe cumplir con el siguiente patrón: a to z, A to Z, 0 to 9, and _.

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

Respuesta

string

Indica si la llamada fue exitosa. “success” si fue exitosa, “error” si no.

{
  "status": "success"
}

Solución de problemas

Código de estado 400
Código de estado 401
Código de estado 404
Código de estado 429

Relacionado con el objeto

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

No autorizado

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

No encontrado

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

Límite de tasa alcanzado

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

Chunked InitEsta documentación ofrece una descripción completa del endpoint POST /v1/objects/chunked de la API de SquareCloud Blob.

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 de Blob

Subida en Partes

Respuesta

Solución de problemas

Relacionado con el objeto

No autorizado

No encontrado

Límite de tasa alcanzado

​Respuesta

​Solución de problemas

​Relacionado con el objeto

​No autorizado

​No encontrado

​Límite de tasa alcanzado

Respuesta

Solución de problemas

Relacionado con el objeto

No autorizado

No encontrado

Límite de tasa alcanzado