Blob Chunked Upload Status

GET

objects

chunked

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "parts": [
      { "part": 1, "size": 16777216, "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\"" },
      { "part": 2, "size": 16777216, "etag": "\"4a2f0b1c9d8e7f6a5b4c3d2e1f0a9b8c\"" },
      { "part": 4, "size": 16777216, "etag": "\"e1f0a9b8c4a2f0b1c9d8e7f6a5b4c3d2\"" }
    ],
    "next_part": 3,
    "size_so_far": 50331648
  }
}

string

erforderlich

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

Chunked Status listet die Teile eines offenen Uploads auf, die bereits gespeichert sind. Nutze den Endpoint, um nach einem Absturz, einer verlorenen Verbindung oder einem Neuladen der Seite fortzufahren: Sende nur die fehlenden Teile mit Chunked Part und rufe dann Chunked Complete auf. Erfordert den Scope blob:write. Wenn du auch das upload-Token verloren hast, listet Open Uploads jeden offenen Upload des Kontos mit seinem Token auf.

string

erforderlich

Das von Chunked Init zurückgegebene upload-Token.

Rate Limits

10 Requests pro 10 Sekunden (RATE_LIMITED, 429). Nutze sie, um einen Upload fortzusetzen, nicht um den Fortschritt abzufragen: Dein Client weiß bereits, welche Teile er gesendet hat.

Antwort

string

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

object

Anzeigen Objekt umschalten

string

Die id, die die Datei nach dem Abschluss haben wird.

array

Die gespeicherten Teile, jeweils als { "part", "size", "etag" }.

number

Die niedrigste Teilnummer, die noch nicht gespeichert ist.

number

Die bisher insgesamt gespeicherten Bytes.

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "parts": [
      { "part": 1, "size": 16777216, "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\"" },
      { "part": 2, "size": 16777216, "etag": "\"4a2f0b1c9d8e7f6a5b4c3d2e1f0a9b8c\"" },
      { "part": 4, "size": 16777216, "etag": "\"e1f0a9b8c4a2f0b1c9d8e7f6a5b4c3d2\"" }
    ],
    "next_part": 3,
    "size_so_far": 50331648
  }
}

Fehler

Code	HTTP	Wann
`INVALID_UPLOAD_TOKEN`	400	Das `upload`-Token fehlt, ist fehlerhaft oder gehört nicht dir.
`UPLOAD_NOT_FOUND`	404	Der Upload wurde abgeschlossen, abgebrochen oder ist abgelaufen.
`RATE_LIMITED`	429	Mehr als 10 Requests in 10 Sekunden.

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "parts": [
      { "part": 1, "size": 16777216, "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\"" },
      { "part": 2, "size": 16777216, "etag": "\"4a2f0b1c9d8e7f6a5b4c3d2e1f0a9b8c\"" },
      { "part": 4, "size": 16777216, "etag": "\"e1f0a9b8c4a2f0b1c9d8e7f6a5b4c3d2\"" }
    ],
    "next_part": 3,
    "size_so_far": 50331648
  }
}

Erste Schritte

Objekte

Chunked-Uploads

Konto

Freigabelinks

S3

Blob Chunked Upload Status

Rate Limits

Antwort

Fehler

​Rate Limits

​Antwort

​Fehler

Rate Limits

Antwort

Fehler