Blob Chunked Upload Status

GET

objects

chunked

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "parts": [
      { "part": 1, "size": 16777216, "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\"" },
      { "part": 2, "size": 16777216, "etag": "\"4a2f0b1c9d8e7f6a5b4c3d2e1f0a9b8c\"" },
      { "part": 4, "size": 16777216, "etag": "\"e1f0a9b8c4a2f0b1c9d8e7f6a5b4c3d2\"" }
    ],
    "next_part": 3,
    "size_so_far": 50331648
  }
}

string

obbligatorio

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

Chunked Status elenca le parti di un upload aperto che sono già archiviate. Usalo per riprendere dopo un crash, una connessione persa o un ricaricamento della pagina: invia solo le parti mancanti con Chunked Part, poi chiama Chunked Complete. Richiede lo scope blob:write. Se hai perso anche il token upload, Open Uploads elenca tutti gli upload aperti dell’account con il relativo token.

string

obbligatorio

Il token upload restituito da Chunked Init.

Limiti di frequenza

10 richieste ogni 10 secondi (RATE_LIMITED, 429). Usala per riprendere un upload, non per monitorare l’avanzamento: il tuo client sa già quali parti ha inviato.

Risposta

string

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

object

Mostra Mostra oggetto

string

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

array

Le parti archiviate, ciascuna come { "part", "size", "etag" }.

number

Il numero di parte più basso non ancora archiviato.

number

Il totale dei byte archiviati finora.

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "parts": [
      { "part": 1, "size": 16777216, "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\"" },
      { "part": 2, "size": 16777216, "etag": "\"4a2f0b1c9d8e7f6a5b4c3d2e1f0a9b8c\"" },
      { "part": 4, "size": 16777216, "etag": "\"e1f0a9b8c4a2f0b1c9d8e7f6a5b4c3d2\"" }
    ],
    "next_part": 3,
    "size_so_far": 50331648
  }
}

Errori

Codice	HTTP	Quando
`INVALID_UPLOAD_TOKEN`	400	Il token `upload` manca, è malformato o non ti appartiene.
`UPLOAD_NOT_FOUND`	404	L’upload è stato completato, annullato o è scaduto.
`RATE_LIMITED`	429	Più di 10 richieste in 10 secondi.

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "parts": [
      { "part": 1, "size": 16777216, "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\"" },
      { "part": 2, "size": 16777216, "etag": "\"4a2f0b1c9d8e7f6a5b4c3d2e1f0a9b8c\"" },
      { "part": 4, "size": 16777216, "etag": "\"e1f0a9b8c4a2f0b1c9d8e7f6a5b4c3d2\"" }
    ],
    "next_part": 3,
    "size_so_far": 50331648
  }
}

Primi Passi

Oggetti

Upload a Blocchi

Account

Link di Condivisione

S3

Blob Chunked Upload Status

Limiti di frequenza

Risposta

Errori

​Limiti di frequenza

​Risposta

​Errori

Limiti di frequenza

Risposta

Errori