Consultar el estado de una subida por partes

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.

Parámetros

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.

Relacionado

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

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

Subidas por partes

Cuenta

Enlaces compartidos

S3

Consultar el estado de 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