Dateien löschen

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

erforderlich

Der API-Schlüssel für dein Konto. Du findest ihn in deinen Kontoeinstellungen.

Delete entfernt eine Datei oder bis zu 100 Dateien in einem einzigen Request. Ein Löschvorgang ist sofort und endgültig: Die Datei wird nicht mehr ausgeliefert und ihr Platz wird in deinem Kontingent freigegeben. Erfordert den Scope blob:write. Löschen erfordert keinen aktiven Plan, sodass du jederzeit aufräumen kannst.

Eine id (object oder objects mit einem einzigen Eintrag): antwortet mit 200, wenn gelöscht, und mit 404 OBJECT_NOT_FOUND, wenn die Datei nicht existiert.
Zwei oder mehr ids (objects): antwortet immer mit 200 und dem Ergebnis jeder Datei, sodass eine fehlende Datei nicht den Rest scheitern lässt. Wiederholte ids zählen einmal.

Eine id, die fehlerhaft ist oder zu einem anderen Konto gehört, lässt den gesamten Request mit 400 INVALID_OBJECT scheitern, bevor irgendetwas gelöscht wird. Um die ids zu finden, verwende die Objektliste.

Parameter

string

Die id der zu löschenden Datei. Sende object oder objects.

string[]

Bis zu 100 ids, die in einem Request gelöscht werden sollen.

Rate Limits

1000 Dateien pro 10 Sekunden, pro Datei gezählt: Ein Stapel von 100 zählt als 100. Darüber hinaus wird das Konto für kurze Zeit gesperrt (RATE_LIMITED, 429).

Antwort

string

“success” bei Erfolg, “error” bei Misserfolg.

object

Nur bei Stapeln vorhanden (zwei oder mehr ids).

Anzeigen Objekt umschalten

string[]

Die ids, die gelöscht wurden.

string[]

Die ids, die nicht existierten.

object[]

Die ids, die nicht gelöscht werden konnten, jeweils als { "id", "code" }. Versuche sie erneut.

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": []
  }
}

Fehler

Code	HTTP	Wann
`INVALID_BODY`	400	Der Body fehlt oder ist kein JSON-Objekt.
`INVALID_OBJECT`	400	Es wurde keine id gesendet, oder eine id ist fehlerhaft oder gehört nicht dir.
`TOO_MANY_OBJECTS`	400	Mehr als 100 ids.
`OBJECT_NOT_FOUND`	404	Die Datei existiert nicht (einzelne Datei).
`RATE_LIMITED`	429	Mehr als 1000 gelöschte Dateien in 10 Sekunden.
`DELETE_FAILED`	500	Der Speicher ist fehlgeschlagen und die Datei existiert möglicherweise noch. Versuche es erneut.

Siehe auch

Blob SDK: 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": []
  }
}

Erste Schritte

Objekte

Chunked-Uploads

Konto

Freigabelinks

S3

Parameter

Rate Limits

Antwort

Fehler

Siehe auch

​Parameter

​Rate Limits

​Antwort

​Fehler

​Siehe auch

Parameter

Rate Limits

Antwort

Fehler

Siehe auch