Blob チャンクアップロードの送信

curl --request PUT \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN&part=1' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@./chunk-1.bin'

const chunk = file.slice(0, 16 * 1024 * 1024); // first 16 MB

const params = new URLSearchParams({ upload: uploadToken, part: '1' });

const response = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
  method: 'PUT',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/octet-stream',
  },
  body: chunk,
});

import requests

with open('./bigfile.bin', 'rb') as f:
    chunk = f.read(16 * 1024 * 1024)

response = requests.put(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY', 'Content-Type': 'application/octet-stream'},
    params={'upload': upload_token, 'part': 1},
    data=chunk,
)

{
  "status": "success",
  "response": {
    "part": 1,
    "size": 16777216,
    "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\""
  }
}

string

必須

アカウントの API キーです。これはアカウント設定で確認できます。

チャンクの送信 (Chunked Part) は、チャンクの開始で開始したアップロードのチャンクを 1 つ送信します。ボディはチャンクの生のバイト列であり、multipart/form-data ではありません。パート番号は 1 から max_parts (205) までで、任意の順序で送信できます。失敗したパートは同じ番号でそのまま再送すればよく、パートは冪等なので再送しても安全です。最後のチャンクを除くすべてのチャンクは 5 MB〜32 MB である必要があり、最後のチャンクはこれより小さくても構いません。並列で送信するパートは最大 6 つまでにしてください。7 つ目の送信中パートは TOO_MANY_CONCURRENT_CHUNKS を返すため、その場合はいずれかの完了を待ってからそのパートを再試行します。6 パート並列であれば、ブラウザでは 16 MB のチャンクが適切なデフォルトです。このルートはアカウント全体の API バジェット (plan.rate) の対象外なので、長時間のアップロードがプラットフォームの他の部分の API クォータを使い果たすことはありません。このルート独自のリミッターは 10 秒あたり 60 パートを許可し、超過すると 10 秒間ブロックされます。

string

必須

チャンクの開始が返した不透明な upload トークン。

number

必須

パート番号 (1〜205)。パートは任意の順序で送信できます。

binary

必須

チャンクの生のバイト列 (Content-Type: application/octet-stream)。multipart/form-data ではありません。

レスポンス

string

呼び出しが成功したかどうかを示します。成功した場合は “success”、失敗した場合は “error” です。

object

表示オブジェクトを展開

number

保存されたパート番号。

number

保存されたチャンクのサイズ (バイト単位)。

string

パートのストレージ ETag。情報提供のみです。完了処理はパート一覧をストレージから読み直すため、クライアントから送り返すことはありません。

curl --request PUT \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN&part=1' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@./chunk-1.bin'

const chunk = file.slice(0, 16 * 1024 * 1024); // first 16 MB

const params = new URLSearchParams({ upload: uploadToken, part: '1' });

const response = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
  method: 'PUT',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/octet-stream',
  },
  body: chunk,
});

import requests

with open('./bigfile.bin', 'rb') as f:
    chunk = f.read(16 * 1024 * 1024)

response = requests.put(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY', 'Content-Type': 'application/octet-stream'},
    params={'upload': upload_token, 'part': 1},
    data=chunk,
)

{
  "status": "success",
  "response": {
    "part": 1,
    "size": 16777216,
    "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\""
  }
}

トラブルシューティング

チャンク関連

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

// The part number must be an integer between 1 and 205.
{
    "status": "error",
    "code": "INVALID_CHUNK_PART"
}

// The chunk body was empty.
{
    "status": "error",
    "code": "EMPTY_CHUNK"
}

認証エラー

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

// The account has no active paid plan. Uploading to Blob Storage requires a paid plan.
{
    "status": "error",
    "code": "PERMISSION_DENIED"
}

見つかりません

// The upload was already completed, aborted, or expired.
{
    "status": "error",
    "code": "UPLOAD_NOT_FOUND"
}

ペイロードが大きすぎます

// Each chunk accepts up to 32 MB.
{
    "status": "error",
    "code": "CHUNK_TOO_LARGE"
}

レート制限

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

// At most 6 chunks may be in flight at a time. Wait for one to finish, then retry this part.
{
    "status": "error",
    "code": "TOO_MANY_CONCURRENT_CHUNKS"
}

アップロード失敗

// Failed to upload the chunk. Retry this part.
{
    "status": "error",
    "code": "UPLOAD_FAILED"
}

チャンクの完了このドキュメントでは、SquareCloud Blob API の PATCH /v1/objects/chunked エンドポイントの概要を包括的に説明します。

curl --request PUT \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN&part=1' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@./chunk-1.bin'

const chunk = file.slice(0, 16 * 1024 * 1024); // first 16 MB

const params = new URLSearchParams({ upload: uploadToken, part: '1' });

const response = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
  method: 'PUT',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/octet-stream',
  },
  body: chunk,
});

import requests

with open('./bigfile.bin', 'rb') as f:
    chunk = f.read(16 * 1024 * 1024)

response = requests.put(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY', 'Content-Type': 'application/octet-stream'},
    params={'upload': upload_token, 'part': 1},
    data=chunk,
)

{
  "status": "success",
  "response": {
    "part": 1,
    "size": 16777216,
    "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\""
  }
}

​レスポンス

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

​チャンク関連

​認証エラー

​見つかりません

​ペイロードが大きすぎます

​レート制限

​アップロード失敗

レスポンス

トラブルシューティング

チャンク関連

認証エラー

見つかりません

ペイロードが大きすぎます

レート制限

アップロード失敗