Einen Teil eines Chunked Uploads hochladen

curl --request PUT \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN&part=1' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@./chunk-1.bin'

const PART_SIZE = 16 * 1024 * 1024;
const total = Math.ceil(file.size / PART_SIZE);

async function sendPart(n) {
  const body = file.slice((n - 1) * PART_SIZE, n * PART_SIZE);
  const params = new URLSearchParams({ upload: uploadToken, part: String(n) });
  const res = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
    method: 'PUT',
    headers: { Authorization: 'YOUR_API_KEY', 'Content-Type': 'application/octet-stream' },
    body,
  });
  if (res.status === 429 || res.status >= 500) return sendPart(n); // add a backoff in production
  if (!res.ok) throw new Error((await res.json()).code);
}

// 6 workers, each taking the next part number
let next = 1;
await Promise.all(Array.from({ length: 6 }, async () => {
  while (next <= total) await sendPart(next++);
}));

import requests

with open('./bigfile.bin', 'rb') as f:
    chunk = f.read(16 * 1024 * 1024)

response = requests.put(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY', 'Content-Type': 'application/octet-stream'},
    params={'upload': upload_token, 'part': 1},
    data=chunk,
)

{
  "status": "success",
  "response": {
    "part": 1,
    "size": 16777216,
    "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\""
  }
}

string

erforderlich

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

Chunked Part sendet einen Teil eines Uploads, der mit Chunked Init geöffnet wurde. Der Body sind die rohen Bytes des Teils, nicht multipart/form-data. Teilnummern reichen von 1 bis 2048 und können in beliebiger Reihenfolge gesendet werden. Das erneute Senden eines Teils mit derselben Nummer ersetzt ihn, sodass ein fehlgeschlagener Teil einfach wiederholt werden kann. Jeder Teil außer dem letzten muss 5 MB bis 32 MB groß sein; der letzte darf kleiner sein. Sende höchstens 6 Teile parallel pro Konto: Ein siebter antwortet mit TOO_MANY_CONCURRENT_CHUNKS, und du wiederholst diesen Teil, sobald ein anderer fertig ist. Mit 6 gleichzeitig laufenden Teilen sind 16-MB-Teile ein guter Standard für einen Browser. Diese Route hat ein eigenes Limit von 60 Teilen pro 10 Sekunden und verbraucht nicht das kontoweite API-Budget, sodass ein langer Upload dein API-Kontingent für den Rest der Plattform nicht aufbrauchen kann. Erfordert den Scope blob:write oder das Upload-Token, das den Upload geöffnet hat, sowie einen aktiven Plan.

Parameter

string

erforderlich

Das von Chunked Init zurückgegebene upload-Token.

number

erforderlich

Die Teilnummer, von 1 bis 2048.

binary

erforderlich

Die rohen Bytes des Teils (Content-Type: application/octet-stream).

Antwort

string

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

object

Anzeigen Objekt umschalten

number

Die gespeicherte Teilnummer.

number

Die Größe des Teils in Bytes.

string

Das ETag des Teils. Nur zur Information: Chunked Complete liest die Teileliste auf dem Server, du sendest es also nie zurück.

curl --request PUT \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN&part=1' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@./chunk-1.bin'

const PART_SIZE = 16 * 1024 * 1024;
const total = Math.ceil(file.size / PART_SIZE);

async function sendPart(n) {
  const body = file.slice((n - 1) * PART_SIZE, n * PART_SIZE);
  const params = new URLSearchParams({ upload: uploadToken, part: String(n) });
  const res = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
    method: 'PUT',
    headers: { Authorization: 'YOUR_API_KEY', 'Content-Type': 'application/octet-stream' },
    body,
  });
  if (res.status === 429 || res.status >= 500) return sendPart(n); // add a backoff in production
  if (!res.ok) throw new Error((await res.json()).code);
}

// 6 workers, each taking the next part number
let next = 1;
await Promise.all(Array.from({ length: 6 }, async () => {
  while (next <= total) await sendPart(next++);
}));

import requests

with open('./bigfile.bin', 'rb') as f:
    chunk = f.read(16 * 1024 * 1024)

response = requests.put(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY', 'Content-Type': 'application/octet-stream'},
    params={'upload': upload_token, 'part': 1},
    data=chunk,
)

{
  "status": "success",
  "response": {
    "part": 1,
    "size": 16777216,
    "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\""
  }
}

Fehler

Code	HTTP	Wann
`INVALID_UPLOAD_TOKEN`	400	Das `upload`-Token fehlt, ist fehlerhaft oder gehört nicht dir.
`INVALID_CHUNK_PART`	400	`part` ist keine Ganzzahl von 1 bis 2048.
`EMPTY_CHUNK`	400	Der Body ist leer.
`PERMISSION_DENIED`	401	Das Konto hat keinen aktiven Plan.
`UPLOAD_NOT_FOUND`	404	Der Upload wurde abgeschlossen, abgebrochen oder ist abgelaufen.
`CHUNK_TOO_LARGE`	413	Der Teil hat mehr als 32 MB.
`FILE_TOO_LARGE`	413	Mit diesem Teil überschreitet der Upload sein Größenlimit.
`TOO_MANY_CONCURRENT_CHUNKS`	429	Es sind bereits 6 Teile unterwegs. Wiederhole diesen Teil, sobald einer fertig ist.
`RATE_LIMITED`	429	Mehr als 60 Teile in 10 Sekunden.
`UPLOAD_FAILED`	500	Der Teil ist fehlgeschlagen. Wiederhole ihn.

Siehe auch

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

curl --request PUT \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN&part=1' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@./chunk-1.bin'

const PART_SIZE = 16 * 1024 * 1024;
const total = Math.ceil(file.size / PART_SIZE);

async function sendPart(n) {
  const body = file.slice((n - 1) * PART_SIZE, n * PART_SIZE);
  const params = new URLSearchParams({ upload: uploadToken, part: String(n) });
  const res = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
    method: 'PUT',
    headers: { Authorization: 'YOUR_API_KEY', 'Content-Type': 'application/octet-stream' },
    body,
  });
  if (res.status === 429 || res.status >= 500) return sendPart(n); // add a backoff in production
  if (!res.ok) throw new Error((await res.json()).code);
}

// 6 workers, each taking the next part number
let next = 1;
await Promise.all(Array.from({ length: 6 }, async () => {
  while (next <= total) await sendPart(next++);
}));

import requests

with open('./bigfile.bin', 'rb') as f:
    chunk = f.read(16 * 1024 * 1024)

response = requests.put(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY', 'Content-Type': 'application/octet-stream'},
    params={'upload': upload_token, 'part': 1},
    data=chunk,
)

{
  "status": "success",
  "response": {
    "part": 1,
    "size": 16777216,
    "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\""
  }
}

Erste Schritte

Objekte

Chunked-Uploads

Konto

Freigabelinks

S3

Einen Teil eines Chunked Uploads hochladen

Parameter

Antwort

Fehler

Siehe auch

​Parameter

​Antwort

​Fehler

​Siehe auch

Parameter

Antwort

Fehler

Siehe auch