Elimina file da Blob Storage

DELETE

objects

curl --request DELETE \
  --url 'https://blob.squarecloud.app/v1/objects' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "object": "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png" }'

curl --request DELETE \
  --url 'https://blob.squarecloud.app/v1/objects' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "objects": [
      "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
      "prv/3155597145698959364/images/draft_mugws5c0-1b4f0e9851971998e732078544c96b36.png",
      "pub/3155597145698959364/images/old.png"
    ]
  }'

const response = await fetch('https://blob.squarecloud.app/v1/objects', {
  method: 'DELETE',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ objects: ids.slice(0, 100) }),
});

{
  "status": "success"
}

{
  "status": "success",
  "response": {
    "deleted": [
      "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
      "prv/3155597145698959364/images/draft_mugws5c0-1b4f0e9851971998e732078544c96b36.png"
    ],
    "not_found": ["pub/3155597145698959364/images/old.png"],
    "failed": []
  }
}

string

obbligatorio

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

Delete rimuove un file, oppure fino a 100 file in una singola richiesta. Un’eliminazione è immediata e definitiva: il file smette di essere distribuito e il suo spazio viene liberato dalla tua quota. Richiede lo scope blob:write. L’eliminazione non richiede un piano attivo, quindi puoi sempre fare pulizia.

Un id (object, oppure objects con una sola voce): risponde 200 quando il file è eliminato, 404 OBJECT_NOT_FOUND quando il file non esiste.
Due o più id (objects): risponde sempre 200 con il risultato di ciascun file, così un file mancante non fa fallire gli altri. Gli id ripetuti contano una volta sola.

Un id malformato o appartenente a un altro account fa fallire l’intera richiesta con 400 INVALID_OBJECT, prima che venga eliminato qualsiasi cosa. Per trovare gli id, usa Object List.

Parametri

string

L’id del file da eliminare. Invia object oppure objects.

string[]

Fino a 100 id da eliminare in una sola richiesta.

Limiti di frequenza

1000 file ogni 10 secondi, conteggiati per file: un blocco di 100 conta come 100. Oltre questa soglia l’account viene bloccato per un breve periodo (RATE_LIMITED, 429).

Risposta

string

“success” in caso di successo, “error” in caso contrario.

object

Presente solo per le operazioni in blocco (due o più id).

Mostra Mostra oggetto

string[]

Gli id eliminati.

string[]

Gli id che non esistevano.

object[]

Gli id che non è stato possibile eliminare, ciascuno come { "id", "code" }. Riprova con questi.

curl --request DELETE \
  --url 'https://blob.squarecloud.app/v1/objects' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "object": "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png" }'

curl --request DELETE \
  --url 'https://blob.squarecloud.app/v1/objects' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "objects": [
      "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
      "prv/3155597145698959364/images/draft_mugws5c0-1b4f0e9851971998e732078544c96b36.png",
      "pub/3155597145698959364/images/old.png"
    ]
  }'

const response = await fetch('https://blob.squarecloud.app/v1/objects', {
  method: 'DELETE',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ objects: ids.slice(0, 100) }),
});

{
  "status": "success"
}

{
  "status": "success",
  "response": {
    "deleted": [
      "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
      "prv/3155597145698959364/images/draft_mugws5c0-1b4f0e9851971998e732078544c96b36.png"
    ],
    "not_found": ["pub/3155597145698959364/images/old.png"],
    "failed": []
  }
}

Errori

Codice	HTTP	Quando
`INVALID_BODY`	400	Il corpo manca o non è un oggetto JSON.
`INVALID_OBJECT`	400	Non è stato inviato alcun id, oppure un id è malformato o non ti appartiene.
`TOO_MANY_OBJECTS`	400	Più di 100 id.
`OBJECT_NOT_FOUND`	404	Il file non esiste (file singolo).
`RATE_LIMITED`	429	Più di 1000 file eliminati in 10 secondi.
`DELETE_FAILED`	500	Lo storage ha avuto un errore e il file potrebbe esistere ancora. Riprova.

Vedi anche

SDK Blob: blob.delete()

curl --request DELETE \
  --url 'https://blob.squarecloud.app/v1/objects' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "object": "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png" }'

curl --request DELETE \
  --url 'https://blob.squarecloud.app/v1/objects' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "objects": [
      "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
      "prv/3155597145698959364/images/draft_mugws5c0-1b4f0e9851971998e732078544c96b36.png",
      "pub/3155597145698959364/images/old.png"
    ]
  }'

const response = await fetch('https://blob.squarecloud.app/v1/objects', {
  method: 'DELETE',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ objects: ids.slice(0, 100) }),
});

{
  "status": "success"
}

{
  "status": "success",
  "response": {
    "deleted": [
      "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
      "prv/3155597145698959364/images/draft_mugws5c0-1b4f0e9851971998e732078544c96b36.png"
    ],
    "not_found": ["pub/3155597145698959364/images/old.png"],
    "failed": []
  }
}

Primi passi

Oggetti

Upload a blocchi

Account

Link di condivisione

S3

Elimina file da Blob Storage

Parametri

Limiti di frequenza

Risposta

Errori

Vedi anche

​Parametri

​Limiti di frequenza

​Risposta

​Errori

​Vedi anche

Parametri

Limiti di frequenza

Risposta

Errori

Vedi anche