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

requis

La clé d’API de votre compte. Vous pouvez la trouver dans les paramètres de votre compte.

Chunked Complete scelle un upload ouvert avec Chunked Init : les parts stockées sont assemblées en objet final, qui devient disponible à son URL publique. Vous n’envoyez aucun ETag et aucune liste de parts, seulement le jeton upload ; la liste des parts est relue depuis le stockage, qui fait déjà autorité sur les parts effectivement reçues. Deux modes d’échec laissent délibérément l’upload ouvert afin que vous puissiez corriger le problème et réessayer le PATCH au lieu de renvoyer jusqu’à 1 GiB : STORAGE_QUOTA_EXCEEDED (libérez de l’espace, puis réessayez) et CHUNK_TOO_SMALL (renvoyez les parts fautives, puis réessayez). FILE_TOO_SMALL et FILE_TOO_LARGE annulent l’upload à la place. La limite de débit est de 5 finalisations par 10 secondes, afin que plusieurs uploads parallèles puissent se terminer en même temps.

string

requis

Le jeton upload opaque renvoyé par Chunked Init.

{ "upload": "UPLOAD_TOKEN" }

Réponse

string

Indique si l’appel a réussi. “success” en cas de succès, “error” sinon.

object

Afficher Afficher l'objet

string

L’ID (clé) de l’objet stocké.

number

La taille totale de l’objet assemblé, en octets.

number

Le nombre de parts à partir desquelles l’objet a été assemblé.

string

L’URL CDN publique de l’objet.

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

Dépannage

Lié à l’upload

// 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 autorisé

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

Quota de stockage dépassé

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

Introuvable

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

Charge utile trop volumineuse

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

Limite de débit atteinte

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

Échec de l’upload

// 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 AbortCette documentation fournit une vue d'ensemble complète de l'endpoint DELETE /v1/objects/chunked de l'API Blob de 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"
  }
}

Endpoints Blob

Upload par Morceaux

Blob Chunked Upload Complete

Réponse

Dépannage

Lié à l’upload

Non autorisé

Quota de stockage dépassé

Introuvable

Charge utile trop volumineuse

Limite de débit atteinte

Échec de l’upload

​Réponse

​Dépannage

​Lié à l’upload

​Non autorisé

​Quota de stockage dépassé

​Introuvable

​Charge utile trop volumineuse

​Limite de débit atteinte

​Échec de l’upload

Réponse

Dépannage

Lié à l’upload

Non autorisé

Quota de stockage dépassé

Introuvable

Charge utile trop volumineuse

Limite de débit atteinte

Échec de l’upload