Completar una subida por partes

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

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "size": 2147483648,
    "parts": 128
  }
}

string

requerido

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

Chunked Complete ensambla las partes enviadas con Chunked Part en el archivo final. La lista de partes se lee en el servidor, así que solo envías el token upload. Una vez que responde, el archivo queda almacenado y cuenta para tu cuota. Requiere el scope blob:write, o el token de subida que abrió la subida, y un plan activo. Lo que ocurre ante un rechazo depende de la causa:

La subida se mantiene abierta cuando la cuenta no tiene plan activo (PERMISSION_DENIED), supera su cuota (STORAGE_QUOTA_EXCEEDED) o el almacenamiento no está disponible (503). Corrige la causa y vuelve a llamar a Complete, sin reenviar ninguna parte.
La subida se aborta y sus partes se descartan cuando el archivo tiene menos de 512 bytes (FILE_TOO_SMALL) o supera su límite (FILE_TOO_LARGE).
No cambia nada cuando aún no se envió ninguna parte (NO_CHUNKS_UPLOADED) o una parte que no es la última tiene menos de 5 MB (CHUNK_TOO_SMALL): reenvía esa parte y vuelve a completar.

Parámetros

string

requerido

El token upload devuelto por Chunked Init. También puede ir en el parámetro de query upload.

Límites de tasa

5 solicitudes cada 10 segundos, para que varias subidas en paralelo puedan terminar a la vez (RATE_LIMITED, 429).

Respuesta

string

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

object

Mostrar Alternar objeto

string

El id del archivo almacenado.

boolean

Si el archivo es privado.

string | null

La URL pública, o null para los archivos privados.

ISO 8601

Cuándo se eliminará el archivo. Solo aparece cuando expira.

number

El tamaño del archivo, en bytes.

number

Cuántas partes se ensamblaron.

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

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "size": 2147483648,
    "parts": 128
  }
}

Errores

Código	HTTP	Cuándo
`INVALID_UPLOAD_TOKEN`	400	El token `upload` falta, está mal formado o no es tuyo.
`NO_CHUNKS_UPLOADED`	400	Aún no se envió ninguna parte.
`CHUNK_TOO_SMALL`	400	Una parte que no es la última tiene menos de 5 MB.
`FILE_TOO_SMALL`	400	El archivo tiene menos de 512 bytes. La subida se aborta.
`PERMISSION_DENIED`	401	La cuenta no tiene un plan activo. La subida se mantiene abierta.
`STORAGE_QUOTA_EXCEEDED`	403	El archivo superaría el almacenamiento incluido. La subida se mantiene abierta.
`UPLOAD_NOT_FOUND`	404	La subida se completó, se abortó o expiró.
`FILE_TOO_LARGE`	413	El archivo supera su límite de tamaño. La subida se aborta.
`RATE_LIMITED`	429	Más de 5 solicitudes en 10 segundos.
`UPLOAD_FAILED`	500	El ensamblado falló. Reintenta.
`PRIVATE_STORAGE_UNAVAILABLE` / `PUBLIC_STORAGE_UNAVAILABLE`	503	El almacenamiento no está disponible temporalmente. La subida se mantiene abierta.

Relacionado

SDK de Blob: blob.put() ejecuta todo el flujo de subida por partes para archivos de más de 90 MiB

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

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "size": 2147483648,
    "parts": 128
  }
}

Primeros pasos

Objetos

Subidas por partes

Cuenta

Enlaces compartidos

S3

Completar una subida por partes

Parámetros

Límites de tasa

Respuesta

Errores

Relacionado

​Parámetros

​Límites de tasa

​Respuesta

​Errores

​Relacionado

Parámetros

Límites de tasa

Respuesta

Errores

Relacionado