Chunked Upload abschließen

curl --request PATCH \
  --url 'https://blob.squarecloud.app/v1/objects/chunked' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "upload": "UPLOAD_TOKEN" }'

const response = await fetch('https://blob.squarecloud.app/v1/objects/chunked', {
  method: 'PATCH',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "size": 2147483648,
    "parts": 128
  }
}

string

erforderlich

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

Chunked Complete setzt die mit Chunked Part gesendeten Teile zur endgültigen Datei zusammen. Die Teileliste wird auf dem Server gelesen, du sendest also nur das upload-Token. Sobald der Endpoint antwortet, ist die Datei gespeichert und zählt gegen dein Kontingent. Erfordert den Scope blob:write oder das Upload-Token, das den Upload geöffnet hat, sowie einen aktiven Plan. Was bei einer Ablehnung passiert, hängt von der Ursache ab:

Der Upload bleibt offen, wenn das Konto keinen aktiven Plan hat (PERMISSION_DENIED), über seinem Kontingent liegt (STORAGE_QUOTA_EXCEEDED) oder der Speicher nicht verfügbar ist (503). Behebe die Ursache und rufe Complete erneut auf, ohne einen Teil erneut zu senden.
Der Upload wird abgebrochen und seine Teile verworfen, wenn die Datei kleiner als 512 Bytes (FILE_TOO_SMALL) oder größer als ihr Limit (FILE_TOO_LARGE) ist.
Nichts ändert sich, wenn noch kein Teil gesendet wurde (NO_CHUNKS_UPLOADED) oder ein Teil außer dem letzten unter 5 MB liegt (CHUNK_TOO_SMALL): Sende diesen Teil erneut und schließe noch einmal ab.

Parameter

string

erforderlich

Das von Chunked Init zurückgegebene upload-Token. Es kann auch im Query-Parameter upload stehen.

Rate Limits

5 Requests pro 10 Sekunden, sodass mehrere parallele Uploads gemeinsam abschließen können (RATE_LIMITED, 429).

Antwort

string

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

object

Anzeigen Objekt umschalten

string

Die id der gespeicherten Datei.

boolean

Ob die Datei privat ist.

string | null

Die öffentliche URL oder null bei privaten Dateien.

ISO 8601

Wann die Datei gelöscht wird. Nur vorhanden, wenn sie abläuft.

number

Die Größe der Datei in Bytes.

number

Wie viele Teile zusammengesetzt wurden.

curl --request PATCH \
  --url 'https://blob.squarecloud.app/v1/objects/chunked' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "upload": "UPLOAD_TOKEN" }'

const response = await fetch('https://blob.squarecloud.app/v1/objects/chunked', {
  method: 'PATCH',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "size": 2147483648,
    "parts": 128
  }
}

Fehler

Code	HTTP	Wann
`INVALID_UPLOAD_TOKEN`	400	Das `upload`-Token fehlt, ist fehlerhaft oder gehört nicht dir.
`NO_CHUNKS_UPLOADED`	400	Es wurde noch kein Teil gesendet.
`CHUNK_TOO_SMALL`	400	Ein Teil außer dem letzten hat weniger als 5 MB.
`FILE_TOO_SMALL`	400	Die Datei hat weniger als 512 Bytes. Der Upload wird abgebrochen.
`PERMISSION_DENIED`	401	Das Konto hat keinen aktiven Plan. Der Upload bleibt offen.
`STORAGE_QUOTA_EXCEEDED`	403	Die Datei würde den enthaltenen Speicher überschreiten. Der Upload bleibt offen.
`UPLOAD_NOT_FOUND`	404	Der Upload wurde abgeschlossen, abgebrochen oder ist abgelaufen.
`FILE_TOO_LARGE`	413	Die Datei überschreitet ihr Größenlimit. Der Upload wird abgebrochen.
`RATE_LIMITED`	429	Mehr als 5 Requests in 10 Sekunden.
`UPLOAD_FAILED`	500	Das Zusammensetzen ist fehlgeschlagen. Versuche es erneut.
`PRIVATE_STORAGE_UNAVAILABLE` / `PUBLIC_STORAGE_UNAVAILABLE`	503	Der Speicher ist vorübergehend nicht verfügbar. Der Upload bleibt offen.

Siehe auch

Blob SDK: blob.put() führt den gesamten Chunked-Ablauf für Dateien über 90 MiB aus

curl --request PATCH \
  --url 'https://blob.squarecloud.app/v1/objects/chunked' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "upload": "UPLOAD_TOKEN" }'

const response = await fetch('https://blob.squarecloud.app/v1/objects/chunked', {
  method: 'PATCH',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "size": 2147483648,
    "parts": 128
  }
}

Erste Schritte

Objekte

Chunked-Uploads

Konto

Freigabelinks

S3

Chunked Upload abschließen

Parameter

Rate Limits

Antwort

Fehler

Siehe auch

​Parameter

​Rate Limits

​Antwort

​Fehler

​Siehe auch

Parameter

Rate Limits

Antwort

Fehler

Siehe auch