Avvia un upload chunked

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

obbligatorio

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

Chunked Init apre un upload chunked, il flusso per i file oltre il limite di 100 MB della singola richiesta, fino a 10 GiB. Restituisce un token upload opaco che porti con te nelle chiamate successive:

Init

Questa route. Conserva il token upload.

Invia le parti

Chunked Part, in qualsiasi ordine, fino a 6 alla volta.

Completa

Chunked Complete sigilla il file. Oppure Chunked Abort per annullare.

Non esiste una sessione lato server: il token è l’intero stato dell’upload, quindi salvalo se l’upload potrebbe attraversare un ricaricamento della pagina. L’hai perso? Open Uploads elenca gli upload aperti con i relativi token e Chunked Status indica quali parti sono già arrivate. Gli upload inattivi da 24 ore vengono annullati automaticamente.

Parametri

I parametri di query sono gli stessi di Object Post, più filename e mime_type: qui non c’è un involucro multipart, quindi l’estensione deve arrivare dalla query. Richiede lo scope blob:write, oppure un upload token, e un piano attivo.

string

obbligatorio

Il nome del file, senza estensione. Stesso pattern di Object Post.

string

Il nome file originale, estensione inclusa. L’estensione archiviata deriva da esso, poi da mime_type, e in mancanza di entrambi ricade su bin.

string

Usato per l’estensione solo quando filename non ne ha una.

string

Come in Object Post.

boolean

Come in Object Post.

string

Come in Object Post.

boolean

Come in Object Post.

boolean

Come in Object Post.

string

Come in Object Post.

boolean

Come in Object Post.

string

Come in Object Post.

string

Come in Object Post.

Limiti

Dimensione del file: fino a 10 GiB (10.737.418.240 byte), o meno quando una regola o un upload token impostano un limite inferiore.
Dimensione della parte: minimo 5 MB (5.242.880 byte), massimo 32 MB (33.554.432 byte). L’ultima parte può essere più piccola.
Parti per file: fino a 2048.
Upload aperti per account: 32, contando anche gli upload aperti tramite il gateway S3 (TOO_MANY_OPEN_UPLOADS, 429).
Limite di frequenza: 5 aperture ogni 10 secondi.
Un account che ha già superato lo storage incluso non può aprire upload (STORAGE_QUOTA_EXCEEDED).

Leggi i limiti dall’oggetto chunk della risposta invece di codificarli a mano.

Risposta

string

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

object

Mostra Mostra oggetto

string

Il token di upload opaco. Invialo in ogni chiamata successiva del flusso.

string

L’id che il file avrà una volta completato.

boolean

Se il file sarà privato.

string | null

L’URL pubblico che il file avrà, oppure null se è privato.

ISO 8601

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

string

Il nome inviato nella richiesta.

string

Il prefisso, quando ne è stato inviato uno.

object

I limiti di questo upload: min_size e max_size (byte della parte), max_parts e max_object_size (byte del file).

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

Errori

Codice	HTTP	Quando
`INVALID_OBJECT_*` / `INVALID_STORAGE_AUTO_DOWNLOAD`	400	Un parametro non è valido, come in Object Post.
`INVALID_FILE_TYPE` / `BLOCKED_FILE_TYPE` / `FILE_TYPE_NOT_ALLOWED`	400	L’estensione è malformata, bloccata o non consentita dalla regola o dal token.
`PERMISSION_DENIED`	401	L’account non ha un piano attivo.
`UPLOAD_TOKEN_USED`	401	L’upload token non ha più utilizzi disponibili. Un token scaduto risponde `ACCESS_DENIED`.
`STORAGE_QUOTA_EXCEEDED`	403	L’account ha già superato lo storage incluso.
`PREFIX_NOT_ALLOWED`	403	L’upload token è vincolato a un altro prefisso.
`UPGRADE_REQUIRED`	403	Un’opzione richiede un piano superiore.
`TOO_MANY_OPEN_UPLOADS`	429	L’account ha 32 upload aperti. Completane o annullane uno.
`RATE_LIMITED`	429	Più di 5 aperture in 10 secondi.
`UPLOAD_FAILED`	500	Non è stato possibile aprire l’upload. Riprova.
`PRIVATE_STORAGE_UNAVAILABLE` / `PUBLIC_STORAGE_UNAVAILABLE`	503	Lo storage è temporaneamente non disponibile. Riprova.

Vedi anche

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

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

Primi passi

Oggetti

Upload a blocchi

Account

Link di condivisione

S3

Avvia un upload chunked

Parametri

Limiti

Risposta

Errori

Vedi anche

​Parametri

​Limiti

​Risposta

​Errori

​Vedi anche

Parametri

Limiti

Risposta

Errori

Vedi anche