Blob 分块上传中止

curl --request DELETE \
  --url 'https://blob.squarecloud.app/v1/objects/chunked' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "upload": "UPLOAD_TOKEN" }'

const response = await fetch('https://blob.squarecloud.app/v1/objects/chunked', {
  method: 'DELETE',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

import requests

response = requests.delete(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY'},
    json={'upload': upload_token},
)

{
  "status": "success"
}

string

必填

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

Chunked Abort 用于取消通过分块初始化开启的上传，并丢弃已存储的分块。它是幂等的：中止一个已经完成或已被中止的上传仍会报告成功。每当用户放弃上传时都应调用它。在此之前，已存储的分块会一直计入账户 8 个未完成上传的限制，只有服务的回收作业才能释放它们，大约在最后一次活动的 24 小时后。丢失令牌的客户端无法取消上传，因此如果上传会跨越页面刷新，请持久化保存令牌。这是分块流程中限流刻意最宽松的路由（每 10 秒 10 次请求）：批量取消上传绝不应因限流而导致这些上传保持开启状态。

string

必填

由分块初始化返回的不透明 upload 令牌。

{ "upload": "UPLOAD_TOKEN" }

响应

string

指示调用是否成功。成功为 “success”，否则为 “error”。

curl --request DELETE \
  --url 'https://blob.squarecloud.app/v1/objects/chunked' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "upload": "UPLOAD_TOKEN" }'

const response = await fetch('https://blob.squarecloud.app/v1/objects/chunked', {
  method: 'DELETE',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

import requests

response = requests.delete(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY'},
    json={'upload': upload_token},
)

{
  "status": "success"
}

故障排查

400 状态码
401 状态码
429 状态码

上传相关

// The upload token is missing, malformed, or does not belong to your account.
{
    "status": "error",
    "code": "INVALID_UPLOAD_TOKEN"
}

未授权

// The API key is missing or invalid. Set a valid key in the Authorization header.
{
    "status": "error",
    "code": "ACCESS_DENIED"
}

速率受限

// Abort rate limit reached (10 requests per 10s window, blocked for 10s).
{
    "status": "error",
    "code": "RATE_LIMITED"
}

分块完成本文档全面介绍 SquareCloud Blob API 的 PATCH /v1/objects/chunked 端点。

curl --request DELETE \
  --url 'https://blob.squarecloud.app/v1/objects/chunked' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "upload": "UPLOAD_TOKEN" }'

const response = await fetch('https://blob.squarecloud.app/v1/objects/chunked', {
  method: 'DELETE',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

import requests

response = requests.delete(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY'},
    json={'upload': upload_token},
)

{
  "status": "success"
}

​响应

​故障排查

​上传相关

​未授权

​速率受限

响应

故障排查

上传相关

未授权

速率受限