Subir una parte de una subida por partes

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

requerido

La clave de API de tu cuenta. Puedes encontrarla en la configuración de tu cuenta.

Chunked Part envía una parte de una subida abierta con Chunked Init. El cuerpo son los bytes en bruto de la parte, no multipart/form-data. Los números de parte van de 1 a 2048 y pueden enviarse en cualquier orden. Reenviar una parte con el mismo número la reemplaza, así que una parte que falla simplemente se puede reintentar. Todas las partes excepto la última deben tener de 5 MB a 32 MB; la última puede ser menor. Envía como máximo 6 partes en paralelo por cuenta: una séptima responde TOO_MANY_CONCURRENT_CHUNKS, y reintentas esa parte cuando otra termine. Con 6 en curso, las partes de 16 MB son un buen valor por defecto para un navegador. Esta ruta tiene su propio límite de 60 partes cada 10 segundos y no consume el presupuesto de API de toda la cuenta, así que una subida larga no puede agotar tu cuota de API para el resto de la plataforma. Requiere el scope blob:write, o el token de subida que abrió la subida, y un plan activo.

Parámetros

string

requerido

El token upload devuelto por Chunked Init.

number

requerido

El número de parte, de 1 a 2048.

binary

requerido

Los bytes en bruto de la parte (Content-Type: application/octet-stream).

Respuesta

string

“success” si tuvo éxito, “error” si no.

object

Mostrar Alternar objeto

number

El número de parte almacenado.

number

El tamaño de la parte, en bytes.

string

El ETag de la parte. Es informativo: Chunked Complete lee la lista de partes en el servidor, así que nunca lo envías de vuelta.

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

Errores

Código	HTTP	Cuándo
`INVALID_UPLOAD_TOKEN`	400	El token `upload` falta, está mal formado o no es tuyo.
`INVALID_CHUNK_PART`	400	`part` no es un entero de 1 a 2048.
`EMPTY_CHUNK`	400	El cuerpo está vacío.
`PERMISSION_DENIED`	401	La cuenta no tiene un plan activo.
`UPLOAD_NOT_FOUND`	404	La subida se completó, se abortó o expiró.
`CHUNK_TOO_LARGE`	413	La parte tiene más de 32 MB.
`FILE_TOO_LARGE`	413	Con esta parte, la subida supera su límite de tamaño.
`TOO_MANY_CONCURRENT_CHUNKS`	429	Ya hay 6 partes en curso. Reintenta esta parte cuando termine una.
`RATE_LIMITED`	429	Más de 60 partes en 10 segundos.
`UPLOAD_FAILED`	500	La parte falló. Reinténtala.

Relacionado

SDK de Blob: blob.put() ejecuta todo el flujo de subida por partes para archivos de más 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\""
  }
}

Primeros pasos

Objetos

Subidas por partes

Cuenta

Enlaces compartidos

S3

Subir una parte de una subida por partes

Parámetros

Respuesta

Errores

Relacionado

​Parámetros

​Respuesta

​Errores

​Relacionado

Parámetros

Respuesta

Errores

Relacionado