Blob Chunked Upload Init

curl --request POST \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?name=myfile&filename=reads.fastq.gz&expire=30' \
  --header 'Authorization: YOUR_API_KEY'

const params = new URLSearchParams({
  name: 'myfile',
  filename: 'reads.fastq.gz',
  expire: '30',
});

const response = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
  method: 'POST',
  headers: { Authorization: 'YOUR_API_KEY' },
});

const { response: upload } = await response.json();
// persist upload.upload — it is the only handle to this upload

import requests

response = requests.post(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY'},
    params={'name': 'myfile', 'filename': 'reads.fastq.gz', 'expire': 30},
)
upload = response.json()['response']

{
  "status": "success",
  "response": {
    "upload": "MzE1NTU5NzE0NTY5ODk1OTM2NC9teWZpbGUtZXgzMC5mYXN0cS5negoyfjQ4WXcuLi4KMzA",
    "id": "3155597145698959364/myfile-ex30.fastq.gz",
    "name": "myfile",
    "prefix": null,
    "url": "https://public-blob.squarecloud.dev/3155597145698959364/myfile-ex30.fastq.gz",
    "chunk": {
      "min_size": 5242880,
      "max_size": 33554432,
      "max_parts": 205,
      "max_object_size": 1073741824
    }
  }
}

string

requerido

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

Chunked Init abre una subida por fragmentos, el flujo para archivos que superan el límite de 100 MB por solicitud única, hasta 1 GiB. Reserva la clave del objeto y devuelve un token upload opaco que llevas a través de las tres llamadas siguientes: Chunked Part para enviar cada fragmento, Chunked Complete para sellar el objeto, y Chunked Abort para cancelar. No hay sesión en el servidor: el token es todo el estado de la subida, así que persístelo si la subida abarca una recarga de página. Un cliente que pierde su token no puede cancelar la subida, y los fragmentos almacenados cuentan contra el límite de 8 subidas abiertas de la cuenta hasta que el servicio los recupera (unas 24 horas). El contrato de la query es el mismo que el de Object Post, más filename: aquí no hay envoltorio multipart, así que la extensión almacenada tiene que venir de la query string. La subida requiere un plan de pago.

string

requerido

Una cadena que representa el nombre del archivo. (sin extensión)
Debe cumplir el patrón a-z, A-Z, 0-9 y _. (de 3 a 32 caracteres)

string

El nombre de archivo original, extensión incluida (p. ej. reads.fastq.gz). La extensión almacenada se deriva de él, recurriendo al parámetro mime_type como alternativa y, en último caso, a bin.

string

Una cadena que representa el prefijo del archivo.
Debe cumplir el patrón a-z, A-Z, 0-9 y _. (de 3 a 32 caracteres)

number

Un número que indica el periodo de expiración del archivo, en un rango de 7 a 1825 días (5 años).

boolean

Establece en true si se requiere un hash de seguridad.

boolean

Establece en true si el archivo debe configurarse para descarga automática.

Límites

Tamaño del objeto: hasta 1 GiB (1,073,741,824 bytes).
Tamaño de fragmento: 5 MB mínimo, 32 MB máximo (el último fragmento puede ser más pequeño).
Fragmentos por objeto: 205 (los números de parte van de 1 a 205).
Subidas abiertas por cuenta: 8 simultáneas (TOO_MANY_OPEN_UPLOADS, 429).
Límite de tasa: 5 aperturas cada 10 segundos, con bloqueo de 10 segundos al superarlo.

Lee los límites del objeto chunk de la respuesta en lugar de codificarlos de forma fija.

Respuesta

string

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

object

Mostrar Alternar objeto

string

El token opaco de subida. Llévalo en cada llamada posterior del flujo; es el único identificador de esta subida.

string

El ID (clave) bajo el cual se almacenará el objeto.

string

El nombre del archivo.

string

El prefijo bajo el cual se almacenará el archivo (null cuando no se envió ninguno).

string

La URL pública en la CDN desde la que se servirá el objeto una vez completado.

object

Los límites del flujo por fragmentos: min_size y max_size (bytes por fragmento), max_parts y max_object_size (bytes totales).

curl --request POST \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?name=myfile&filename=reads.fastq.gz&expire=30' \
  --header 'Authorization: YOUR_API_KEY'

const params = new URLSearchParams({
  name: 'myfile',
  filename: 'reads.fastq.gz',
  expire: '30',
});

const response = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
  method: 'POST',
  headers: { Authorization: 'YOUR_API_KEY' },
});

const { response: upload } = await response.json();
// persist upload.upload — it is the only handle to this upload

import requests

response = requests.post(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY'},
    params={'name': 'myfile', 'filename': 'reads.fastq.gz', 'expire': 30},
)
upload = response.json()['response']

{
  "status": "success",
  "response": {
    "upload": "MzE1NTU5NzE0NTY5ODk1OTM2NC9teWZpbGUtZXgzMC5mYXN0cS5negoyfjQ4WXcuLi4KMzA",
    "id": "3155597145698959364/myfile-ex30.fastq.gz",
    "name": "myfile",
    "prefix": null,
    "url": "https://public-blob.squarecloud.dev/3155597145698959364/myfile-ex30.fastq.gz",
    "chunk": {
      "min_size": 5242880,
      "max_size": 33554432,
      "max_parts": 205,
      "max_object_size": 1073741824
    }
  }
}

Solución de problemas

Código de estado 400
Código de estado 401
Código de estado 403
Código de estado 429
Código de estado 500

Relacionado con el objeto

// The provided object name is invalid.
// Must adhere to the a to z, A to Z, 0 to 9, and _ pattern.
{
    "status": "error",
    "code": "INVALID_OBJECT_NAME"
}

// The provided object prefix is invalid.
// Must adhere to the a to z, A to Z, 0 to 9, and _ pattern.
{
    "status": "error",
    "code": "INVALID_OBJECT_PREFIX"
}

// The provided expiration value for the object is invalid.
// Must be a number ranging from 7 to 1825. (value in days).
{
    "status": "error",
    "code": "INVALID_OBJECT_EXPIRE"
}

// The file extension is malformed or too long.
{
    "status": "error",
    "code": "INVALID_FILE_TYPE"
}

// Executable/installer extensions (exe, msi, bat, apk, ...) are not accepted.
{
    "status": "error",
    "code": "BLOCKED_FILE_TYPE"
}

No autorizado

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

// The account has no active paid plan. Uploading to Blob Storage requires a paid plan.
{
    "status": "error",
    "code": "PERMISSION_DENIED"
}

Cuota de almacenamiento superada

// You have exceeded your storage quota. Delete some files or upgrade your plan.
{
    "status": "error",
    "code": "STORAGE_QUOTA_EXCEEDED"
}

Límite de tasa alcanzado

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

// 8 chunked uploads already open. Complete or abort one first.
{
    "status": "error",
    "code": "TOO_MANY_OPEN_UPLOADS"
}

Fallo en la subida

// Failed to open the chunked upload. Please try again later.
{
    "status": "error",
    "code": "UPLOAD_FAILED"
}

Chunked PartEsta documentación ofrece una descripción completa del endpoint PUT /v1/objects/chunked de la API de SquareCloud Blob.

curl --request POST \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?name=myfile&filename=reads.fastq.gz&expire=30' \
  --header 'Authorization: YOUR_API_KEY'

const params = new URLSearchParams({
  name: 'myfile',
  filename: 'reads.fastq.gz',
  expire: '30',
});

const response = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
  method: 'POST',
  headers: { Authorization: 'YOUR_API_KEY' },
});

const { response: upload } = await response.json();
// persist upload.upload — it is the only handle to this upload

import requests

response = requests.post(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY'},
    params={'name': 'myfile', 'filename': 'reads.fastq.gz', 'expire': 30},
)
upload = response.json()['response']

{
  "status": "success",
  "response": {
    "upload": "MzE1NTU5NzE0NTY5ODk1OTM2NC9teWZpbGUtZXgzMC5mYXN0cS5negoyfjQ4WXcuLi4KMzA",
    "id": "3155597145698959364/myfile-ex30.fastq.gz",
    "name": "myfile",
    "prefix": null,
    "url": "https://public-blob.squarecloud.dev/3155597145698959364/myfile-ex30.fastq.gz",
    "chunk": {
      "min_size": 5242880,
      "max_size": 33554432,
      "max_parts": 205,
      "max_object_size": 1073741824
    }
  }
}

Endpoints de Blob

Subida en Partes

Blob Chunked Upload Init

Límites

Respuesta

Solución de problemas

Relacionado con el objeto

No autorizado

Cuota de almacenamiento superada

Límite de tasa alcanzado

Fallo en la subida

​Límites

​Respuesta

​Solución de problemas

​Relacionado con el objeto

​No autorizado

​Cuota de almacenamiento superada

​Límite de tasa alcanzado

​Fallo en la subida

Límites

Respuesta

Solución de problemas

Relacionado con el objeto

No autorizado

Cuota de almacenamiento superada

Límite de tasa alcanzado

Fallo en la subida