Iniciar una subida por partes

curl --request POST \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?name=dataset&filename=reads.fastq.gz&prefix=genomics&private=true' \
  --header 'Authorization: YOUR_API_KEY'

const params = new URLSearchParams({
  name: 'dataset',
  filename: file.name,
  prefix: 'genomics',
  private: 'true',
});

const res = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
  method: 'POST',
  headers: { Authorization: 'YOUR_API_KEY' },
});
const { response: upload } = await res.json();
// persist upload.upload: it is the handle to this upload

import requests

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

{
  "status": "success",
  "response": {
    "upload": "Zk3pQ8vR2mWx7LcT0aYbNe5uHs1JqGd9KoVfBr4XtIy6EwUz.q2Ws8nLc0VbR5TfYp3Hk",
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "name": "dataset",
    "prefix": "genomics",
    "chunk": {
      "min_size": 5242880,
      "max_size": 33554432,
      "max_parts": 2048,
      "max_object_size": 10737418240
    }
  }
}

string

requerido

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

Chunked Init abre una subida por partes, el flujo para archivos que superan el límite de 100 MB de una sola solicitud, hasta 10 GiB. Devuelve un token upload opaco que llevas a las siguientes llamadas:

Iniciar

Esta ruta. Guarda el token upload.

Enviar las partes

Chunked Part, en cualquier orden, hasta 6 a la vez.

Completar

Chunked Complete sella el archivo. O Chunked Abort para cancelar.

No hay sesión en el servidor: el token es todo el estado de la subida, así que guárdalo si la subida puede abarcar una recarga de página. ¿Lo perdiste? Open Uploads lista las subidas abiertas con sus tokens, y Chunked Status indica qué partes ya llegaron. Las subidas inactivas durante 24 horas se abortan automáticamente.

Parámetros

Los parámetros de query son los mismos que en Object Post, más filename y mime_type: aquí no hay envoltorio multipart, así que la extensión tiene que venir de la query. Requiere el scope blob:write, o un token de subida, y un plan activo.

string

requerido

El nombre del archivo, sin extensión. Mismo patrón que en Object Post.

string

El nombre de archivo original, con extensión. La extensión almacenada proviene de él, luego de mime_type, y en último caso es bin.

string

Se usa para la extensión solo cuando filename no tiene ninguna.

string

Igual que en Object Post.

boolean

Igual que en Object Post.

string

Igual que en Object Post.

boolean

Igual que en Object Post.

boolean

Igual que en Object Post.

string

Igual que en Object Post.

boolean

Igual que en Object Post.

string

Igual que en Object Post.

string

Igual que en Object Post.

Límites

Tamaño del archivo: hasta 10 GiB (10,737,418,240 bytes), o menos cuando una regla o un token de subida fija un límite menor.
Tamaño de la parte: mínimo 5 MB (5,242,880 bytes), máximo 32 MB (33,554,432 bytes). La última parte puede ser menor.
Partes por archivo: hasta 2048.
Subidas abiertas por cuenta: 32, contando las subidas abiertas a través del gateway S3 (TOO_MANY_OPEN_UPLOADS, 429).
Límite de tasa: 5 aperturas cada 10 segundos.
Una cuenta que ya supera su almacenamiento incluido no puede abrir subidas (STORAGE_QUOTA_EXCEEDED).

Lee los límites del objeto chunk de la respuesta en lugar de fijarlos en el código.

Respuesta

string

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

object

Mostrar Alternar objeto

string

El token de subida opaco. Envíalo en cada llamada posterior del flujo.

string

El id que tendrá el archivo una vez completado.

boolean

Si el archivo será privado.

string | null

La URL pública que tendrá el archivo, o null cuando sea privado.

ISO 8601

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

string

El nombre enviado en la solicitud.

string

El prefijo, cuando se envió uno.

object

Los límites de esta subida: min_size y max_size (bytes por parte), max_parts y max_object_size (bytes del archivo).

curl --request POST \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?name=dataset&filename=reads.fastq.gz&prefix=genomics&private=true' \
  --header 'Authorization: YOUR_API_KEY'

const params = new URLSearchParams({
  name: 'dataset',
  filename: file.name,
  prefix: 'genomics',
  private: 'true',
});

const res = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
  method: 'POST',
  headers: { Authorization: 'YOUR_API_KEY' },
});
const { response: upload } = await res.json();
// persist upload.upload: it is the handle to this upload

import requests

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

{
  "status": "success",
  "response": {
    "upload": "Zk3pQ8vR2mWx7LcT0aYbNe5uHs1JqGd9KoVfBr4XtIy6EwUz.q2Ws8nLc0VbR5TfYp3Hk",
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "name": "dataset",
    "prefix": "genomics",
    "chunk": {
      "min_size": 5242880,
      "max_size": 33554432,
      "max_parts": 2048,
      "max_object_size": 10737418240
    }
  }
}

Errores

Código	HTTP	Cuándo
`INVALID_OBJECT_*` / `INVALID_STORAGE_AUTO_DOWNLOAD`	400	Un parámetro no es válido, como en Object Post.
`INVALID_FILE_TYPE` / `BLOCKED_FILE_TYPE` / `FILE_TYPE_NOT_ALLOWED`	400	La extensión está mal formada, bloqueada o no la permiten la regla o el token.
`PERMISSION_DENIED`	401	La cuenta no tiene un plan activo.
`UPLOAD_TOKEN_USED`	401	Al token de subida no le quedan usos. Un token expirado responde `ACCESS_DENIED`.
`STORAGE_QUOTA_EXCEEDED`	403	La cuenta ya supera su almacenamiento incluido.
`PREFIX_NOT_ALLOWED`	403	El token de subida está vinculado a otro prefijo.
`UPGRADE_REQUIRED`	403	Una opción requiere un plan superior.
`TOO_MANY_OPEN_UPLOADS`	429	La cuenta tiene 32 subidas abiertas. Completa o aborta una.
`RATE_LIMITED`	429	Más de 5 aperturas en 10 segundos.
`UPLOAD_FAILED`	500	No se pudo abrir la subida. Reintenta.
`PRIVATE_STORAGE_UNAVAILABLE` / `PUBLIC_STORAGE_UNAVAILABLE`	503	El almacenamiento no está disponible temporalmente. Reintenta.

Relacionado

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

curl --request POST \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?name=dataset&filename=reads.fastq.gz&prefix=genomics&private=true' \
  --header 'Authorization: YOUR_API_KEY'

const params = new URLSearchParams({
  name: 'dataset',
  filename: file.name,
  prefix: 'genomics',
  private: 'true',
});

const res = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
  method: 'POST',
  headers: { Authorization: 'YOUR_API_KEY' },
});
const { response: upload } = await res.json();
// persist upload.upload: it is the handle to this upload

import requests

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

{
  "status": "success",
  "response": {
    "upload": "Zk3pQ8vR2mWx7LcT0aYbNe5uHs1JqGd9KoVfBr4XtIy6EwUz.q2Ws8nLc0VbR5TfYp3Hk",
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "name": "dataset",
    "prefix": "genomics",
    "chunk": {
      "min_size": 5242880,
      "max_size": 33554432,
      "max_parts": 2048,
      "max_object_size": 10737418240
    }
  }
}

Primeros pasos

Objetos

Subidas por partes

Cuenta

Enlaces compartidos

S3

Iniciar una subida por partes

Parámetros

Límites

Respuesta

Errores

Relacionado

​Parámetros

​Límites

​Respuesta

​Errores

​Relacionado

Parámetros

Límites

Respuesta

Errores

Relacionado