Blob チャンクアップロードの状態

GET

objects

chunked

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "parts": [
      { "part": 1, "size": 16777216, "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\"" },
      { "part": 2, "size": 16777216, "etag": "\"4a2f0b1c9d8e7f6a5b4c3d2e1f0a9b8c\"" },
      { "part": 4, "size": 16777216, "etag": "\"e1f0a9b8c4a2f0b1c9d8e7f6a5b4c3d2\"" }
    ],
    "next_part": 3,
    "size_so_far": 50331648
  }
}

string

必須

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

チャンクの状態は、未完了のアップロードのうち、すでに保存されているパートを一覧表示します。クラッシュ、接続の切断、ページの再読み込みの後に再開するために使用します: 不足しているパートだけをチャンクの送信で送信し、その後チャンクの完了を呼び出します。blob:write スコープが必要です。 upload トークンも紛失した場合は、未完了のアップロードがアカウントのすべての未完了のアップロードをトークン付きで一覧表示します。

string

必須

チャンクの開始で返された upload トークン。

レート制限

10 秒間に 10 リクエスト (RATE_LIMITED、429)。アップロードの再開に使用し、進捗のポーリングには使用しないでください: 送信済みのパートはクライアントがすでに把握しています。

レスポンス

string

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

object

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

string

完了後にファイルに付与される id。

array

保存されたパート。それぞれ { "part", "size", "etag" } の形式です。

number

まだ保存されていない最小のパート番号。

number

これまでに保存された合計バイト数。

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "parts": [
      { "part": 1, "size": 16777216, "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\"" },
      { "part": 2, "size": 16777216, "etag": "\"4a2f0b1c9d8e7f6a5b4c3d2e1f0a9b8c\"" },
      { "part": 4, "size": 16777216, "etag": "\"e1f0a9b8c4a2f0b1c9d8e7f6a5b4c3d2\"" }
    ],
    "next_part": 3,
    "size_so_far": 50331648
  }
}

エラー

コード	HTTP	発生する状況
`INVALID_UPLOAD_TOKEN`	400	`upload` トークンがない、形式が正しくない、またはあなたのものではない。
`UPLOAD_NOT_FOUND`	404	アップロードは完了、中止、または期限切れになった。
`RATE_LIMITED`	429	10 秒間に 10 リクエストを超えた。

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "parts": [
      { "part": 1, "size": 16777216, "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\"" },
      { "part": 2, "size": 16777216, "etag": "\"4a2f0b1c9d8e7f6a5b4c3d2e1f0a9b8c\"" },
      { "part": 4, "size": 16777216, "etag": "\"e1f0a9b8c4a2f0b1c9d8e7f6a5b4c3d2\"" }
    ],
    "next_part": 3,
    "size_so_far": 50331648
  }
}

はじめに

オブジェクト

チャンクアップロード

アカウント

共有リンク

S3

Blob チャンクアップロードの状態

レート制限

レスポンス

エラー

​レート制限

​レスポンス

​エラー

レート制限

レスポンス

エラー