Blob 分块上传状态

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

必填

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

分块状态会列出一个未完成上传中已经存储的分块。在崩溃、连接中断或页面刷新之后，可用它来恢复上传：只通过分块发送发送缺失的分块，然后调用分块完成。需要 blob:write scope。如果你连 upload 令牌也弄丢了，未完成上传会列出账户所有未完成的上传及其令牌。

string

必填

分块初始化返回的 upload 令牌。

速率限制

每 10 秒 10 次请求（RATE_LIMITED，429）。用它来恢复上传，而不是轮询进度：你的客户端已经知道它发送了哪些分段。

响应

string

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

object

显示展开对象

string

文件完成后将拥有的 id。

array

已存储的分块，每个以 { "part", "size", "etag" } 表示。

number

尚未存储的最小分块编号。

number

到目前为止已存储的总字节数。

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
  }
}

错误

代码	HTTP	触发情况
`INVALID_UPLOAD_TOKEN`	400	`upload` 令牌缺失、格式错误或不属于你。
`UPLOAD_NOT_FOUND`	404	该上传已完成、已中止或已过期。
`RATE_LIMITED`	429	10 秒内超过 10 次请求。

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
  }
}

入门

对象

分块上传

账户

分享链接

S3

Blob 分块上传状态

速率限制

响应

错误

​速率限制

​响应

​错误

速率限制

响应

错误