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

requerido

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

Chunked Complete sella una subida abierta con Chunked Init: las partes almacenadas se ensamblan en el objeto final, que pasa a estar disponible en su URL pública. No envías ni ETags ni lista de partes, solo el token upload; la lista de partes se vuelve a leer desde el almacenamiento, que ya es la autoridad sobre qué partes llegaron. Dos modos de fallo dejan deliberadamente la subida abierta para que puedas corregir el problema y reintentar el PATCH en lugar de volver a subir hasta 1 GiB: STORAGE_QUOTA_EXCEEDED (libera espacio y reintenta) y CHUNK_TOO_SMALL (reenvía las partes afectadas y reintenta). FILE_TOO_SMALL y FILE_TOO_LARGE abortan la subida en su lugar. El límite de tasa es de 5 finalizaciones cada 10 segundos, de modo que varias subidas paralelas pueden terminar al mismo tiempo.

string

requerido

El token upload opaco devuelto por Chunked Init.

{ "upload": "UPLOAD_TOKEN" }

Respuesta

string

Indica si la llamada fue exitosa. “success” si tuvo éxito, “error” si no.

object

Mostrar Alternar objeto

string

El ID (clave) del objeto almacenado.

number

El tamaño total del objeto ensamblado, en bytes.

number

De cuántas partes se ensambló el objeto.

string

La URL pública en la CDN del objeto.

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

Solución de problemas

Relacionado con la subida

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

No autorizado

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

Cuota de almacenamiento superada

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

No encontrado

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

Carga útil demasiado grande

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

Límite de tasa alcanzado

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

Fallo en la subida

// 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 AbortEsta documentación ofrece una descripción completa del endpoint DELETE /v1/objects/chunked de la API de SquareCloud Blob.

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 de Blob

Subida en Partes

Blob Chunked Upload Complete

Respuesta

Solución de problemas

Relacionado con la subida

No autorizado

Cuota de almacenamiento superada

No encontrado

Carga útil demasiado grande

Límite de tasa alcanzado

Fallo en la subida

​Respuesta

​Solución de problemas

​Relacionado con la subida

​No autorizado

​Cuota de almacenamiento superada

​No encontrado

​Carga útil demasiado grande

​Límite de tasa alcanzado

​Fallo en la subida

Respuesta

Solución de problemas

Relacionado con la subida

No autorizado

Cuota de almacenamiento superada

No encontrado

Carga útil demasiado grande

Límite de tasa alcanzado

Fallo en la subida