Chunked Upload starten

curl --request POST \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?name=dataset&filename=reads.fastq.gz&prefix=genomics&private=true' \
  --header 'Authorization: YOUR_API_KEY'

const params = new URLSearchParams({
  name: 'dataset',
  filename: file.name,
  prefix: 'genomics',
  private: 'true',
});

const res = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
  method: 'POST',
  headers: { Authorization: 'YOUR_API_KEY' },
});
const { response: upload } = await res.json();
// persist upload.upload: it is the handle to this upload

import requests

response = requests.post(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY'},
    params={'name': 'dataset', 'filename': 'reads.fastq.gz', 'prefix': 'genomics', 'private': 'true'},
)
upload = response.json()['response']

{
  "status": "success",
  "response": {
    "upload": "Zk3pQ8vR2mWx7LcT0aYbNe5uHs1JqGd9KoVfBr4XtIy6EwUz.q2Ws8nLc0VbR5TfYp3Hk",
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "name": "dataset",
    "prefix": "genomics",
    "chunk": {
      "min_size": 5242880,
      "max_size": 33554432,
      "max_parts": 2048,
      "max_object_size": 10737418240
    }
  }
}

string

erforderlich

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

Chunked Init öffnet einen Chunked Upload, den Ablauf für Dateien über dem Limit von 100 MB pro Request, bis 10 GiB. Er gibt ein opakes upload-Token zurück, das du durch die nächsten Aufrufe mitnimmst:

Init

Diese Route. Bewahre das upload-Token auf.

Teile senden

Chunked Part, in beliebiger Reihenfolge, bis zu 6 gleichzeitig.

Abschließen

Chunked Complete versiegelt die Datei. Oder Chunked Abort zum Abbrechen.

Es gibt keine serverseitige Sitzung: Das Token ist der gesamte Zustand des Uploads, also speichere es, falls der Upload ein Neuladen der Seite überdauern könnte. Verloren? Open Uploads listet die offenen Uploads mit ihren Tokens auf, und Chunked Status zeigt, welche Teile bereits angekommen sind. Uploads, die 24 Stunden inaktiv sind, werden automatisch abgebrochen.

Parameter

Die Query-Parameter sind dieselben wie in Object Post, plus filename und mime_type: Hier gibt es keine Multipart-Hülle, daher muss die Endung aus der Query kommen. Erfordert den Scope blob:write oder ein Upload-Token sowie einen aktiven Plan.

string

erforderlich

Der Dateiname, ohne Endung. Dasselbe Muster wie in Object Post.

string

Der ursprüngliche Dateiname, einschließlich Endung. Die gespeicherte Endung stammt daraus, dann aus mime_type, und fällt sonst auf bin zurück.

string

Wird für die Endung nur verwendet, wenn filename keine hat.

string

Wie in Object Post.

boolean

Wie in Object Post.

string

Wie in Object Post.

boolean

Wie in Object Post.

boolean

Wie in Object Post.

string

Wie in Object Post.

boolean

Wie in Object Post.

string

Wie in Object Post.

string

Wie in Object Post.

Limits

Dateigröße: bis 10 GiB (10.737.418.240 Bytes), oder weniger, wenn eine Regel oder ein Upload-Token ein kleineres Limit festlegt.
Größe eines Teils: mindestens 5 MB (5.242.880 Bytes), höchstens 32 MB (33.554.432 Bytes). Der letzte Teil darf kleiner sein.
Teile pro Datei: bis 2048.
Offene Uploads pro Konto: 32, einschließlich der über das S3-Gateway geöffneten Uploads (TOO_MANY_OPEN_UPLOADS, 429).
Rate Limit: 5 Öffnungen pro 10 Sekunden.
Ein Konto, das bereits über seinem enthaltenen Speicher liegt, kann keine Uploads öffnen (STORAGE_QUOTA_EXCEEDED).

Lies die Limits aus dem Objekt chunk der Antwort, statt sie fest zu codieren.

Antwort

string

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

object

Anzeigen Objekt umschalten

string

Das opake Upload-Token. Sende es bei jedem weiteren Aufruf des Ablaufs mit.

string

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

boolean

Ob die Datei privat sein wird.

string | null

Die öffentliche URL, die die Datei haben wird, oder null, wenn sie privat ist.

ISO 8601

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

string

Der im Request gesendete Name.

string

Das Präfix, falls eines gesendet wurde.

object

Die Limits dieses Uploads: min_size und max_size (Bytes pro Teil), max_parts und max_object_size (Bytes der Datei).

curl --request POST \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?name=dataset&filename=reads.fastq.gz&prefix=genomics&private=true' \
  --header 'Authorization: YOUR_API_KEY'

const params = new URLSearchParams({
  name: 'dataset',
  filename: file.name,
  prefix: 'genomics',
  private: 'true',
});

const res = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
  method: 'POST',
  headers: { Authorization: 'YOUR_API_KEY' },
});
const { response: upload } = await res.json();
// persist upload.upload: it is the handle to this upload

import requests

response = requests.post(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY'},
    params={'name': 'dataset', 'filename': 'reads.fastq.gz', 'prefix': 'genomics', 'private': 'true'},
)
upload = response.json()['response']

{
  "status": "success",
  "response": {
    "upload": "Zk3pQ8vR2mWx7LcT0aYbNe5uHs1JqGd9KoVfBr4XtIy6EwUz.q2Ws8nLc0VbR5TfYp3Hk",
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "name": "dataset",
    "prefix": "genomics",
    "chunk": {
      "min_size": 5242880,
      "max_size": 33554432,
      "max_parts": 2048,
      "max_object_size": 10737418240
    }
  }
}

Fehler

Code	HTTP	Wann
`INVALID_OBJECT_*` / `INVALID_STORAGE_AUTO_DOWNLOAD`	400	Ein Parameter ist ungültig, wie in Object Post.
`INVALID_FILE_TYPE` / `BLOCKED_FILE_TYPE` / `FILE_TYPE_NOT_ALLOWED`	400	Die Endung ist fehlerhaft, gesperrt oder von der Regel bzw. dem Token nicht erlaubt.
`PERMISSION_DENIED`	401	Das Konto hat keinen aktiven Plan.
`UPLOAD_TOKEN_USED`	401	Das Upload-Token hat keine Nutzungen mehr übrig. Ein abgelaufenes Token antwortet mit `ACCESS_DENIED`.
`STORAGE_QUOTA_EXCEEDED`	403	Das Konto liegt bereits über seinem enthaltenen Speicher.
`PREFIX_NOT_ALLOWED`	403	Das Upload-Token ist an ein anderes Präfix gebunden.
`UPGRADE_REQUIRED`	403	Eine Option erfordert einen höheren Plan.
`TOO_MANY_OPEN_UPLOADS`	429	Das Konto hat 32 offene Uploads. Schließe einen ab oder brich einen ab.
`RATE_LIMITED`	429	Mehr als 5 Öffnungen in 10 Sekunden.
`UPLOAD_FAILED`	500	Der Upload konnte nicht geöffnet werden. Versuche es erneut.
`PRIVATE_STORAGE_UNAVAILABLE` / `PUBLIC_STORAGE_UNAVAILABLE`	503	Der Speicher ist vorübergehend nicht verfügbar. Versuche es erneut.

Siehe auch

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

curl --request POST \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?name=dataset&filename=reads.fastq.gz&prefix=genomics&private=true' \
  --header 'Authorization: YOUR_API_KEY'

const params = new URLSearchParams({
  name: 'dataset',
  filename: file.name,
  prefix: 'genomics',
  private: 'true',
});

const res = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
  method: 'POST',
  headers: { Authorization: 'YOUR_API_KEY' },
});
const { response: upload } = await res.json();
// persist upload.upload: it is the handle to this upload

import requests

response = requests.post(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY'},
    params={'name': 'dataset', 'filename': 'reads.fastq.gz', 'prefix': 'genomics', 'private': 'true'},
)
upload = response.json()['response']

{
  "status": "success",
  "response": {
    "upload": "Zk3pQ8vR2mWx7LcT0aYbNe5uHs1JqGd9KoVfBr4XtIy6EwUz.q2Ws8nLc0VbR5TfYp3Hk",
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "name": "dataset",
    "prefix": "genomics",
    "chunk": {
      "min_size": 5242880,
      "max_size": 33554432,
      "max_parts": 2048,
      "max_object_size": 10737418240
    }
  }
}

Erste Schritte

Objekte

Chunked-Uploads

Konto

Freigabelinks

S3

Parameter

Limits

Antwort

Fehler

Siehe auch

​Parameter

​Limits

​Antwort

​Fehler

​Siehe auch

Parameter

Limits

Antwort

Fehler

Siehe auch