Completa un upload chunked

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

obbligatorio

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

Chunked Complete assembla le parti inviate con Chunked Part nel file finale. L’elenco delle parti viene letto sul server, quindi invii solo il token upload. Una volta che risponde, il file è archiviato e conta nella tua quota. Richiede lo scope blob:write, oppure l’upload token che ha aperto l’upload, e un piano attivo. Cosa succede in caso di rifiuto dipende dalla causa:

L’upload resta aperto quando l’account non ha un piano attivo (PERMISSION_DENIED), ha superato la quota (STORAGE_QUOTA_EXCEEDED) o lo storage non è disponibile (503). Risolvi la causa e chiama di nuovo Complete, senza reinviare alcuna parte.
L’upload viene annullato e le sue parti scartate quando il file è più piccolo di 512 byte (FILE_TOO_SMALL) o più grande del suo limite (FILE_TOO_LARGE).
Non cambia nulla quando non è stata ancora inviata alcuna parte (NO_CHUNKS_UPLOADED) o una parte diversa dall’ultima è sotto i 5 MB (CHUNK_TOO_SMALL): reinvia quella parte e completa di nuovo.

Parametri

string

obbligatorio

Il token upload restituito da Chunked Init. Può anche essere passato nel parametro di query upload.

Limiti di frequenza

5 richieste ogni 10 secondi, così più upload paralleli possono terminare insieme (RATE_LIMITED, 429).

Risposta

string

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

object

Mostra Mostra oggetto

string

L’id del file archiviato.

boolean

Se il file è privato.

string | null

L’URL pubblico, oppure null per i file privati.

ISO 8601

Quando il file verrà eliminato. Presente solo se il file scade.

number

La dimensione del file, in byte.

number

Quante parti sono state assemblate.

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

Errori

Codice	HTTP	Quando
`INVALID_UPLOAD_TOKEN`	400	Il token `upload` manca, è malformato o non ti appartiene.
`NO_CHUNKS_UPLOADED`	400	Non è stata ancora inviata alcuna parte.
`CHUNK_TOO_SMALL`	400	Una parte diversa dall’ultima ha meno di 5 MB.
`FILE_TOO_SMALL`	400	Il file ha meno di 512 byte. L’upload viene annullato.
`PERMISSION_DENIED`	401	L’account non ha un piano attivo. L’upload resta aperto.
`STORAGE_QUOTA_EXCEEDED`	403	Il file supererebbe lo storage incluso. L’upload resta aperto.
`UPLOAD_NOT_FOUND`	404	L’upload è stato completato, annullato o è scaduto.
`FILE_TOO_LARGE`	413	Il file supera il suo limite di dimensione. L’upload viene annullato.
`RATE_LIMITED`	429	Più di 5 richieste in 10 secondi.
`UPLOAD_FAILED`	500	L’assemblaggio non è riuscito. Riprova.
`PRIVATE_STORAGE_UNAVAILABLE` / `PUBLIC_STORAGE_UNAVAILABLE`	503	Lo storage è temporaneamente non disponibile. L’upload resta aperto.

Vedi anche

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

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

Primi passi

Oggetti

Upload a blocchi

Account

Link di condivisione

S3

Completa un upload chunked

Parametri

Limiti di frequenza

Risposta

Errori

Vedi anche

​Parametri

​Limiti di frequenza

​Risposta

​Errori

​Vedi anche

Parametri

Limiti di frequenza

Risposta

Errori

Vedi anche