Blob チャンクアップロードの完了

curl --request PATCH \
  --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: 'PATCH',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

import requests

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

{
  "status": "success",
  "response": {
    "id": "3155597145698959364/myfile-ex30.fastq.gz",
    "size": 734003200,
    "parts": 22,
    "url": "https://public-blob.squarecloud.dev/3155597145698959364/myfile-ex30.fastq.gz"
  }
}

string

必須

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

チャンクの完了 (Chunked Complete) は、チャンクの開始で開始したアップロードを確定します。保存済みのパートが最終的なオブジェクトへと組み立てられ、公開 URL で利用できるようになります。送信するのは upload トークンのみで、ETag もパート一覧も送信しません。パート一覧は、どのパートが到達したかについてすでに信頼できる情報源であるストレージから読み直されます。 2 つの失敗モードでは、最大 1 GiB を再アップロードする代わりに、問題を解決してから PATCH を再試行できるよう、アップロードは意図的にオープンのまま残されます: STORAGE_QUOTA_EXCEEDED (空き容量を確保してから再試行) と CHUNK_TOO_SMALL (問題のパートを再送してから再試行) です。一方、FILE_TOO_SMALL と FILE_TOO_LARGE はアップロードを中止します。レート制限は 10 秒あたり 5 回の完了なので、複数の並列アップロードが同時に完了できます。

string

必須

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

{ "upload": "UPLOAD_TOKEN" }

レスポンス

string

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

object

表示オブジェクトを展開

string

保存されたオブジェクトの ID (キー)。

number

組み立てられたオブジェクトの合計サイズ (バイト単位)。

number

オブジェクトの組み立てに使われたパート数。

string

オブジェクトの公開 CDN URL。

curl --request PATCH \
  --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: 'PATCH',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

import requests

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

{
  "status": "success",
  "response": {
    "id": "3155597145698959364/myfile-ex30.fastq.gz",
    "size": 734003200,
    "parts": 22,
    "url": "https://public-blob.squarecloud.dev/3155597145698959364/myfile-ex30.fastq.gz"
  }
}

トラブルシューティング

アップロード関連

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

// The upload has no stored chunks to assemble.
{
    "status": "error",
    "code": "NO_CHUNKS_UPLOADED"
}

// A chunk other than the last is below 5 MB. The upload stays open:
// re-send the offending parts, then retry the PATCH.
{
    "status": "error",
    "code": "CHUNK_TOO_SMALL"
}

// The assembled object is below 512 bytes. The upload is aborted.
{
    "status": "error",
    "code": "FILE_TOO_SMALL"
}

認証エラー

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

ストレージのクォータ超過

// The account filled up while the parts were uploading. The upload is
// LEFT OPEN: free space (or upgrade) and retry the PATCH, or abort it
// with DELETE /v1/objects/chunked.
{
    "status": "error",
    "code": "STORAGE_QUOTA_EXCEEDED"
}

見つかりません

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

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

// The assembled object exceeds 1 GiB. The upload is aborted.
{
    "status": "error",
    "code": "FILE_TOO_LARGE"
}

レート制限

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

アップロード失敗

// Failed to assemble or register the object. If the message says to start
// a new upload, the uploadId was consumed: open a new upload and send the
// file again. Otherwise, retry the PATCH.
{
    "status": "error",
    "code": "UPLOAD_FAILED"
}

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

curl --request PATCH \
  --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: 'PATCH',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

import requests

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

{
  "status": "success",
  "response": {
    "id": "3155597145698959364/myfile-ex30.fastq.gz",
    "size": 734003200,
    "parts": 22,
    "url": "https://public-blob.squarecloud.dev/3155597145698959364/myfile-ex30.fastq.gz"
  }
}

​レスポンス

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

​アップロード関連

​認証エラー

​ストレージのクォータ超過

​見つかりません

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

​レート制限

​アップロード失敗

レスポンス

トラブルシューティング

アップロード関連

認証エラー

ストレージのクォータ超過

見つかりません

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

レート制限

アップロード失敗