Blob Chunked Upload Status

GET

objects

chunked

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "parts": [
      { "part": 1, "size": 16777216, "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\"" },
      { "part": 2, "size": 16777216, "etag": "\"4a2f0b1c9d8e7f6a5b4c3d2e1f0a9b8c\"" },
      { "part": 4, "size": 16777216, "etag": "\"e1f0a9b8c4a2f0b1c9d8e7f6a5b4c3d2\"" }
    ],
    "next_part": 3,
    "size_so_far": 50331648
  }
}

string

requerido

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

Chunked Status lista las partes de una subida abierta que ya están almacenadas. Úsalo para reanudar tras un fallo, una conexión perdida o una recarga de página: envía solo las partes que faltan con Chunked Part y luego llama a Chunked Complete. Requiere el scope blob:write. Si también perdiste el token upload, Open Uploads lista todas las subidas abiertas de la cuenta con su token.

string

requerido

El token upload devuelto por Chunked Init.

Límites de tasa

10 solicitudes cada 10 segundos (RATE_LIMITED, 429). Úsalo para reanudar una subida, no para consultar el progreso: tu cliente ya sabe qué partes envió.

Respuesta

string

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

object

Mostrar Alternar objeto

string

El id que tendrá el archivo una vez completado.

array

Las partes almacenadas, cada una como { "part", "size", "etag" }.

number

El número de parte más bajo que aún no está almacenado.

number

El total de bytes almacenados hasta ahora.

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "parts": [
      { "part": 1, "size": 16777216, "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\"" },
      { "part": 2, "size": 16777216, "etag": "\"4a2f0b1c9d8e7f6a5b4c3d2e1f0a9b8c\"" },
      { "part": 4, "size": 16777216, "etag": "\"e1f0a9b8c4a2f0b1c9d8e7f6a5b4c3d2\"" }
    ],
    "next_part": 3,
    "size_so_far": 50331648
  }
}

Errores

Código	HTTP	Cuándo
`INVALID_UPLOAD_TOKEN`	400	El token `upload` falta, está mal formado o no es tuyo.
`UPLOAD_NOT_FOUND`	404	La subida se completó, se abortó o expiró.
`RATE_LIMITED`	429	Más de 10 solicitudes en 10 segundos.

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "parts": [
      { "part": 1, "size": 16777216, "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\"" },
      { "part": 2, "size": 16777216, "etag": "\"4a2f0b1c9d8e7f6a5b4c3d2e1f0a9b8c\"" },
      { "part": 4, "size": 16777216, "etag": "\"e1f0a9b8c4a2f0b1c9d8e7f6a5b4c3d2\"" }
    ],
    "next_part": 3,
    "size_so_far": 50331648
  }
}

Primeros Pasos

Objetos

Subida en Partes

Cuenta

Enlaces Compartidos

S3

Blob Chunked Upload Status

Límites de tasa

Respuesta

Errores

​Límites de tasa

​Respuesta

​Errores

Límites de tasa

Respuesta

Errores