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

​レスポンス

​トラブルシューティング

​アップロード関連

​認証エラー

​レート制限

レスポンス

トラブルシューティング

アップロード関連

認証エラー

レート制限