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 }),
});

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "size": 2147483648,
    "parts": 128
  }
}

string

必須

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

チャンクの完了は、チャンクの送信で送信されたパートを最終的なファイルに組み立てます。パートの一覧はサーバー上で読み取られるため、送信するのは upload トークンだけです。応答が返った時点でファイルは保存され、ストレージ枠にカウントされます。blob:write スコープ、またはアップロードを開始したアップロードトークンと、有効なプランが必要です。拒否された場合の動作は原因によって異なります。

アカウントに有効なプランがない (PERMISSION_DENIED)、ストレージ枠を超えている (STORAGE_QUOTA_EXCEEDED)、またはストレージが利用できない (503) 場合、アップロードは開いたまま保持されます。原因を解決してから、パートを再送信せずに完了をもう一度呼び出してください。
ファイルが 512 バイト未満 (FILE_TOO_SMALL) またはその上限を超えている (FILE_TOO_LARGE) 場合、アップロードは中止され、パートは破棄されます。
まだパートが送信されていない (NO_CHUNKS_UPLOADED)、または最後以外のパートが 5 MB 未満 (CHUNK_TOO_SMALL) の場合、何も変わりません: そのパートを再送信してから、もう一度完了してください。

パラメーター

string

必須

チャンクの開始で返された upload トークン。upload クエリパラメーターで送信することもできます。

レート制限

10 秒間に 5 リクエスト。複数の並行アップロードをまとめて完了できます (RATE_LIMITED、429)。

レスポンス

string

成功した場合は “success”、失敗した場合は “error” です。

object

表示オブジェクトを切り替え

string

保存されたファイルの id。

boolean

ファイルがプライベートかどうか。

string | null

公開 URL。プライベートファイルの場合は null。

ISO 8601

ファイルが削除される日時。有効期限がある場合のみ含まれます。

number

ファイルのサイズ (バイト)。

number

組み立てられたパートの数。

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 }),
});

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "size": 2147483648,
    "parts": 128
  }
}

エラー

コード	HTTP	発生する状況
`INVALID_UPLOAD_TOKEN`	400	`upload` トークンがない、形式が正しくない、またはあなたのものではない。
`NO_CHUNKS_UPLOADED`	400	まだパートが送信されていない。
`CHUNK_TOO_SMALL`	400	最後以外のパートが 5 MB 未満。
`FILE_TOO_SMALL`	400	ファイルが 512 バイト未満。アップロードは中止されます。
`PERMISSION_DENIED`	401	アカウントに有効なプランがない。アップロードは開いたままです。
`STORAGE_QUOTA_EXCEEDED`	403	ファイルが含まれるストレージを超える。アップロードは開いたままです。
`UPLOAD_NOT_FOUND`	404	アップロードは完了、中止、または期限切れになった。
`FILE_TOO_LARGE`	413	ファイルがサイズ上限を超えている。アップロードは中止されます。
`RATE_LIMITED`	429	10 秒間に 5 リクエストを超えた。
`UPLOAD_FAILED`	500	組み立てに失敗した。再試行してください。
`PRIVATE_STORAGE_UNAVAILABLE` / `PUBLIC_STORAGE_UNAVAILABLE`	503	ストレージが一時的に利用できない。アップロードは開いたままです。

はじめに

オブジェクト

チャンクアップロード

アカウント

共有リンク

S3

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

パラメーター

レート制限

レスポンス

エラー

関連項目

​パラメーター

​レート制限

​レスポンス

​エラー

​関連項目

パラメーター

レート制限

レスポンス

エラー

関連項目