Carica una parte di un upload chunked

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

obbligatorio

La chiave API del tuo account. Puoi trovarla nelle impostazioni del tuo account.

Chunked Part invia una parte di un upload aperto con Chunked Init. Il corpo è costituito dai byte grezzi della parte, non da multipart/form-data. I numeri di parte vanno da 1 a 2048 e possono essere inviati in qualsiasi ordine. Reinviare una parte con lo stesso numero la sostituisce, quindi una parte non riuscita può semplicemente essere ritentata. Ogni parte tranne l’ultima deve avere da 5 MB a 32 MB; l’ultima può essere più piccola. Invia al massimo 6 parti in parallelo per account: una settima risponde TOO_MANY_CONCURRENT_CHUNKS, e ritenti quella parte quando un’altra termina. Con 6 in transito, parti da 16 MB sono una buona scelta predefinita per un browser. Questa route ha un proprio limite di 60 parti ogni 10 secondi e non consuma il budget API complessivo dell’account, così un upload lungo non può esaurire la tua quota API per il resto della piattaforma. Richiede lo scope blob:write, oppure l’upload token che ha aperto l’upload, e un piano attivo.

Parametri

string

obbligatorio

Il token upload restituito da Chunked Init.

number

obbligatorio

Il numero della parte, da 1 a 2048.

binary

obbligatorio

I byte grezzi della parte (Content-Type: application/octet-stream).

Risposta

string

“success” in caso di successo, “error” in caso contrario.

object

Mostra Mostra oggetto

number

Il numero della parte archiviata.

number

La dimensione della parte, in byte.

string

L’ETag della parte. Solo informativo: Chunked Complete legge l’elenco delle parti sul server, quindi non devi mai rimandarlo.

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\""
  }
}

Errori

Codice	HTTP	Quando
`INVALID_UPLOAD_TOKEN`	400	Il token `upload` manca, è malformato o non ti appartiene.
`INVALID_CHUNK_PART`	400	`part` non è un intero da 1 a 2048.
`EMPTY_CHUNK`	400	Il corpo è vuoto.
`PERMISSION_DENIED`	401	L’account non ha un piano attivo.
`UPLOAD_NOT_FOUND`	404	L’upload è stato completato, annullato o è scaduto.
`CHUNK_TOO_LARGE`	413	La parte supera i 32 MB.
`FILE_TOO_LARGE`	413	Con questa parte, l’upload supera il suo limite di dimensione.
`TOO_MANY_CONCURRENT_CHUNKS`	429	Sono già in transito 6 parti. Ritenta questa parte quando una termina.
`RATE_LIMITED`	429	Più di 60 parti in 10 secondi.
`UPLOAD_FAILED`	500	La parte non è riuscita. Ritentala.

Vedi anche

SDK Blob: blob.put() esegue l’intero flusso di upload chunked per i file oltre 90 MiB

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\""
  }
}

Primi passi

Oggetti

Upload a blocchi

Account

Link di condivisione

S3

Carica una parte di un upload chunked

Parametri

Risposta

Errori

Vedi anche

​Parametri

​Risposta

​Errori

​Vedi anche

Parametri

Risposta

Errori

Vedi anche