Blob 未完成上传

GET

objects

chunked

open

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

{
  "status": "success",
  "response": {
    "uploads": [
      {
        "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
        "initiated": "2026-09-25T12:00:00.000Z",
        "upload": "Zk3pQ8vR2mWx7LcT0aYbNe5uHs1JqGd9KoVfBr4XtIy6EwUz.q2Ws8nLc0VbR5TfYp3Hk"
      }
    ]
  }
}

string

必填

你账户的 API 密钥。你可以在账户设置中找到它。

未完成上传会列出账户中已开启但尚未完成或中止的上传，包括通过 S3 网关开启的分段上传。每一个都附带一个 upload 令牌，因此即使开启它的客户端已经不在了，你也可以恢复或中止它。未完成的上传计入每个账户 32 个的限制，其分块在完成或中止之前会占用存储空间。空闲 24 小时的上传会被自动中止。需要 blob:write scope。

速率限制

每 10 秒 10 次请求（RATE_LIMITED，429）。

响应

string

成功为 “success”，否则为 “error”。

object

显示展开对象

array

显示展开对象

string

文件完成后将拥有的 id。

ISO 8601

上传开启的时间。

string

用于分块状态、发送、完成和中止的 upload 令牌。

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

{
  "status": "success",
  "response": {
    "uploads": [
      {
        "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
        "initiated": "2026-09-25T12:00:00.000Z",
        "upload": "Zk3pQ8vR2mWx7LcT0aYbNe5uHs1JqGd9KoVfBr4XtIy6EwUz.q2Ws8nLc0VbR5TfYp3Hk"
      }
    ]
  }
}

错误

代码	HTTP	触发情况
`RATE_LIMITED`	429	10 秒内超过 10 次请求。

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

{
  "status": "success",
  "response": {
    "uploads": [
      {
        "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
        "initiated": "2026-09-25T12:00:00.000Z",
        "upload": "Zk3pQ8vR2mWx7LcT0aYbNe5uHs1JqGd9KoVfBr4XtIy6EwUz.q2Ws8nLc0VbR5TfYp3Hk"
      }
    ]
  }
}

入门

对象

分块上传

账户

分享链接

S3

速率限制

响应

错误

​速率限制

​响应

​错误

速率限制

响应

错误