Envoyer une partie d'un envoi chunked

curl --request PUT \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN&part=1' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@./chunk-1.bin'

const PART_SIZE = 16 * 1024 * 1024;
const total = Math.ceil(file.size / PART_SIZE);

async function sendPart(n) {
  const body = file.slice((n - 1) * PART_SIZE, n * PART_SIZE);
  const params = new URLSearchParams({ upload: uploadToken, part: String(n) });
  const res = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
    method: 'PUT',
    headers: { Authorization: 'YOUR_API_KEY', 'Content-Type': 'application/octet-stream' },
    body,
  });
  if (res.status === 429 || res.status >= 500) return sendPart(n); // add a backoff in production
  if (!res.ok) throw new Error((await res.json()).code);
}

// 6 workers, each taking the next part number
let next = 1;
await Promise.all(Array.from({ length: 6 }, async () => {
  while (next <= total) await sendPart(next++);
}));

import requests

with open('./bigfile.bin', 'rb') as f:
    chunk = f.read(16 * 1024 * 1024)

response = requests.put(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY', 'Content-Type': 'application/octet-stream'},
    params={'upload': upload_token, 'part': 1},
    data=chunk,
)

{
  "status": "success",
  "response": {
    "part": 1,
    "size": 16777216,
    "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\""
  }
}

string

requis

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

Chunked Part envoie une partie d’un envoi ouvert avec Chunked Init. Le corps contient les octets bruts de la partie, pas du multipart/form-data. Les numéros de partie vont de 1 à 2048 et peuvent être envoyés dans n’importe quel ordre. Renvoyer une partie avec le même numéro la remplace, une partie en échec peut donc simplement être renvoyée. Chaque partie sauf la dernière doit faire de 5 Mo à 32 Mo ; la dernière peut être plus petite. Envoyez au maximum 6 parties en parallèle par compte : une septième répond TOO_MANY_CONCURRENT_CHUNKS, et vous renvoyez cette partie dès qu’une autre se termine. Avec 6 parties en cours, des parties de 16 Mo sont un bon choix par défaut pour un navigateur. Cette route a sa propre limite de 60 parties par 10 secondes et ne consomme pas le budget d’API de l’ensemble du compte, de sorte qu’un long envoi ne peut pas épuiser votre quota d’API pour le reste de la plateforme. Nécessite le scope blob:write, ou le jeton d’envoi qui a ouvert l’envoi, ainsi qu’un plan actif.

Paramètres

string

requis

Le jeton upload renvoyé par Chunked Init.

number

requis

Le numéro de la partie, de 1 à 2048.

binary

requis

Les octets bruts de la partie (Content-Type: application/octet-stream).

Réponse

string

“success” en cas de succès, “error” sinon.

object

Afficher Afficher l'objet

number

Le numéro de la partie stockée.

number

La taille de la partie, en octets.

string

L’ETag de la partie. À titre informatif : Chunked Complete lit la liste des parties sur le serveur, vous n’avez donc jamais à la renvoyer.

curl --request PUT \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN&part=1' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@./chunk-1.bin'

const PART_SIZE = 16 * 1024 * 1024;
const total = Math.ceil(file.size / PART_SIZE);

async function sendPart(n) {
  const body = file.slice((n - 1) * PART_SIZE, n * PART_SIZE);
  const params = new URLSearchParams({ upload: uploadToken, part: String(n) });
  const res = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
    method: 'PUT',
    headers: { Authorization: 'YOUR_API_KEY', 'Content-Type': 'application/octet-stream' },
    body,
  });
  if (res.status === 429 || res.status >= 500) return sendPart(n); // add a backoff in production
  if (!res.ok) throw new Error((await res.json()).code);
}

// 6 workers, each taking the next part number
let next = 1;
await Promise.all(Array.from({ length: 6 }, async () => {
  while (next <= total) await sendPart(next++);
}));

import requests

with open('./bigfile.bin', 'rb') as f:
    chunk = f.read(16 * 1024 * 1024)

response = requests.put(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY', 'Content-Type': 'application/octet-stream'},
    params={'upload': upload_token, 'part': 1},
    data=chunk,
)

{
  "status": "success",
  "response": {
    "part": 1,
    "size": 16777216,
    "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\""
  }
}

Erreurs

Code	HTTP	Quand
`INVALID_UPLOAD_TOKEN`	400	Le jeton `upload` est absent, mal formé ou ne vous appartient pas.
`INVALID_CHUNK_PART`	400	`part` n’est pas un entier de 1 à 2048.
`EMPTY_CHUNK`	400	Le corps est vide.
`PERMISSION_DENIED`	401	Le compte n’a pas de plan actif.
`UPLOAD_NOT_FOUND`	404	L’envoi a été terminé, annulé ou a expiré.
`CHUNK_TOO_LARGE`	413	La partie dépasse 32 Mo.
`FILE_TOO_LARGE`	413	Avec cette partie, l’envoi dépasse sa limite de taille.
`TOO_MANY_CONCURRENT_CHUNKS`	429	6 parties sont déjà en cours d’envoi. Renvoyez cette partie lorsqu’une autre se termine.
`RATE_LIMITED`	429	Plus de 60 parties en 10 secondes.
`UPLOAD_FAILED`	500	La partie a échoué. Renvoyez-la.

Voir aussi

SDK Blob : blob.put() exécute tout le flux d’envoi chunked pour les fichiers de plus de 90 MiB

curl --request PUT \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN&part=1' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@./chunk-1.bin'

const PART_SIZE = 16 * 1024 * 1024;
const total = Math.ceil(file.size / PART_SIZE);

async function sendPart(n) {
  const body = file.slice((n - 1) * PART_SIZE, n * PART_SIZE);
  const params = new URLSearchParams({ upload: uploadToken, part: String(n) });
  const res = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
    method: 'PUT',
    headers: { Authorization: 'YOUR_API_KEY', 'Content-Type': 'application/octet-stream' },
    body,
  });
  if (res.status === 429 || res.status >= 500) return sendPart(n); // add a backoff in production
  if (!res.ok) throw new Error((await res.json()).code);
}

// 6 workers, each taking the next part number
let next = 1;
await Promise.all(Array.from({ length: 6 }, async () => {
  while (next <= total) await sendPart(next++);
}));

import requests

with open('./bigfile.bin', 'rb') as f:
    chunk = f.read(16 * 1024 * 1024)

response = requests.put(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY', 'Content-Type': 'application/octet-stream'},
    params={'upload': upload_token, 'part': 1},
    data=chunk,
)

{
  "status": "success",
  "response": {
    "part": 1,
    "size": 16777216,
    "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\""
  }
}

Premiers pas

Objets

Uploads par morceaux

Compte

Liens de partage

S3

Envoyer une partie d'un envoi chunked

Paramètres

Réponse

Erreurs

Voir aussi

​Paramètres

​Réponse

​Erreurs

​Voir aussi

Paramètres

Réponse

Erreurs

Voir aussi