Blob Chunked Upload Complete

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 }),
});

import requests

response = requests.patch(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY'},
    json={'upload': upload_token},
)

{
  "status": "success",
  "response": {
    "id": "3155597145698959364/myfile-ex30.fastq.gz",
    "size": 734003200,
    "parts": 22,
    "url": "https://public-blob.squarecloud.dev/3155597145698959364/myfile-ex30.fastq.gz"
  }
}

string

obbligatorio

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

Chunked Complete sigilla un caricamento aperto con Chunked Init: le parti memorizzate vengono assemblate nell’oggetto finale, che diventa disponibile al suo URL pubblico. Non invii né ETag né elenco delle parti, solo il token upload; l’elenco delle parti viene riletto dallo storage, che è già l’autorità su quali parti sono arrivate. Due modalità di errore lasciano deliberatamente il caricamento aperto, così puoi risolvere il problema e ritentare la PATCH invece di ricaricare fino a 1 GiB: STORAGE_QUOTA_EXCEEDED (libera spazio, poi riprova) e CHUNK_TOO_SMALL (reinvia le parti problematiche, poi riprova). FILE_TOO_SMALL e FILE_TOO_LARGE invece annullano il caricamento. Il limite di frequenza è di 5 completamenti ogni 10 secondi, così diversi caricamenti paralleli possono terminare nello stesso momento.

string

obbligatorio

Il token upload opaco restituito da Chunked Init.

{ "upload": "UPLOAD_TOKEN" }

Risposta

string

Indica se la chiamata è andata a buon fine. “success” se riuscita, “error” in caso contrario.

object

Mostra Toggle object

string

L’ID (chiave) dell’oggetto memorizzato.

number

La dimensione totale dell’oggetto assemblato, in byte.

number

Il numero di parti da cui l’oggetto è stato assemblato.

string

L’URL pubblico CDN dell’oggetto.

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 }),
});

import requests

response = requests.patch(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY'},
    json={'upload': upload_token},
)

{
  "status": "success",
  "response": {
    "id": "3155597145698959364/myfile-ex30.fastq.gz",
    "size": 734003200,
    "parts": 22,
    "url": "https://public-blob.squarecloud.dev/3155597145698959364/myfile-ex30.fastq.gz"
  }
}

Risoluzione dei problemi

Relativi al caricamento

// The upload token is missing, malformed, or does not belong to your account.
{
    "status": "error",
    "code": "INVALID_UPLOAD_TOKEN"
}

// The upload has no stored chunks to assemble.
{
    "status": "error",
    "code": "NO_CHUNKS_UPLOADED"
}

// A chunk other than the last is below 5 MB. The upload stays open:
// re-send the offending parts, then retry the PATCH.
{
    "status": "error",
    "code": "CHUNK_TOO_SMALL"
}

// The assembled object is below 512 bytes. The upload is aborted.
{
    "status": "error",
    "code": "FILE_TOO_SMALL"
}

Non autorizzato

// The API key is missing or invalid. Set a valid key in the Authorization header.
{
    "status": "error",
    "code": "ACCESS_DENIED"
}

Quota di archiviazione superata

// The account filled up while the parts were uploading. The upload is
// LEFT OPEN: free space (or upgrade) and retry the PATCH, or abort it
// with DELETE /v1/objects/chunked.
{
    "status": "error",
    "code": "STORAGE_QUOTA_EXCEEDED"
}

Non trovato

// The upload was already completed, aborted, or expired.
{
    "status": "error",
    "code": "UPLOAD_NOT_FOUND"
}

Payload troppo grande

// The assembled object exceeds 1 GiB. The upload is aborted.
{
    "status": "error",
    "code": "FILE_TOO_LARGE"
}

Frequenza limitata

// Complete rate limit reached (5 requests per 10s window, blocked for 10s).
{
    "status": "error",
    "code": "RATE_LIMITED"
}

Caricamento fallito

// Failed to assemble or register the object. If the message says to start
// a new upload, the uploadId was consumed: open a new upload and send the
// file again. Otherwise, retry the PATCH.
{
    "status": "error",
    "code": "UPLOAD_FAILED"
}

Chunked AbortQuesta documentazione fornisce una panoramica completa dell'endpoint DELETE /v1/objects/chunked dell'API Blob di SquareCloud.

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 }),
});

import requests

response = requests.patch(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY'},
    json={'upload': upload_token},
)

{
  "status": "success",
  "response": {
    "id": "3155597145698959364/myfile-ex30.fastq.gz",
    "size": 734003200,
    "parts": 22,
    "url": "https://public-blob.squarecloud.dev/3155597145698959364/myfile-ex30.fastq.gz"
  }
}

Endpoint Blob

Upload a Blocchi

Blob Chunked Upload Complete

Risposta

Risoluzione dei problemi

Relativi al caricamento

Non autorizzato

Quota di archiviazione superata

Non trovato

Payload troppo grande

Frequenza limitata

Caricamento fallito

​Risposta

​Risoluzione dei problemi

​Relativi al caricamento

​Non autorizzato

​Quota di archiviazione superata

​Non trovato

​Payload troppo grande

​Frequenza limitata

​Caricamento fallito

Risposta

Risoluzione dei problemi

Relativi al caricamento

Non autorizzato

Quota di archiviazione superata

Non trovato

Payload troppo grande

Frequenza limitata

Caricamento fallito