Exclusão de Objetos 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

obrigatório

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

Delete remove um único objeto armazenado pela sua chave completa, incluindo o prefixo do ID da conta proprietária. Não existe exclusão em lote: o endpoint sempre atua sobre um único nome, obtido do campo object ou do primeiro item de um array objects (mantido por compatibilidade retroativa), então remover vários arquivos exige uma requisição por objeto. O limite de 10 requisições a cada 10 segundos foi dimensionado exatamente para isso: uma exclusão com multisseleção de 20 arquivos leva cerca de 2 segundos. A chave do objeto é validada contra o ID da conta do seu token antes da exclusão ser executada; uma chave que resolve fora do seu próprio prefixo é rejeitada como INVALID_OBJECT em vez de ser tratada como uma consulta entre contas. Uma única consulta ao banco de dados executa a exclusão e confirma que o objeto existia, então excluir um nome que já foi removido retorna OBJECT_NOT_FOUND. Para encontrar a chave exata do objeto antes de excluí-lo, liste seus objetos com Lista de objetos; para verificar o uso de armazenamento depois da limpeza, veja Estatísticas da conta.

string

obrigatório

O nome do objeto a ser excluído. O nome do objeto deve obedecer ao seguinte padrão: a a z, A a Z, 0 a 9, e _.

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

Resposta

string

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

{
  "status": "success"
}

Solução de problemas

Código 400
Código 401
Código 404
Código 429

Relacionado ao Objeto

// O corpo da requisição está ausente ou não é um objeto JSON válido.
{
    "status": "error",
    "code": "INVALID_BODY"
}

// A chave de objeto fornecida é inválida: ela precisa começar com o prefixo do seu próprio ID de conta e não pode conter path traversal.
{
    "status": "error",
    "code": "INVALID_OBJECT"
}

// A solicitação para excluir os objetos falhou. Por favor, tente novamente.
{
    "status": "error",
    "code": "DELETE_FAILED"
}

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

Não encontrado

// O objeto que você está tentando excluir não existe.
{
    "status": "error",
    "code": "OBJECT_NOT_FOUND"
}

Limite de taxa

// Limite de exclusões atingido (10 requisições por janela de 10s, bloqueio de 10s).
{
    "status": "error",
    "code": "RATE_LIMITED"
}

Exclusão de Objetos Blob

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

Uploads em Partes

Exclusão de Objetos Blob

Resposta

Solução de problemas

Relacionado ao Objeto

Não autorizado

Não encontrado

Limite de taxa

​Resposta

​Solução de problemas

​Relacionado ao Objeto

​Não autorizado

​Não encontrado

​Limite de taxa

Resposta

Solução de problemas

Relacionado ao Objeto

Não autorizado

Não encontrado

Limite de taxa