> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

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

> GET /v1/objects/chunked で、チャンクアップロードのどのパートがすでに届いているかを確認し、中断したアップロードを再開します。

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  アカウントの API キーです。これは[アカウント設定](https://squarecloud.app/ja/account/security)で確認できます。
</ParamField>

チャンクの状態は、未完了のアップロードのうち、すでに保存されているパートを一覧表示します。クラッシュ、接続の切断、ページの再読み込みの後に**再開**するために使用します: 不足しているパートだけを[チャンクの送信](/ja/blob-reference/endpoint/chunked-part)で送信し、その後[チャンクの完了](/ja/blob-reference/endpoint/chunked-complete)を呼び出します。`blob:write` スコープが必要です。

`upload` トークンも紛失した場合は、[未完了のアップロード](/ja/blob-reference/endpoint/chunked-open)がアカウントのすべての未完了のアップロードをトークン付きで一覧表示します。

<ParamField query="upload" type="string" required>
  チャンクの開始で返された `upload` トークン。
</ParamField>

### レート制限

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

### レスポンス

<ResponseField name="status" type="string">
  成功した場合は "success"、失敗した場合は "error" です。
</ResponseField>

<ResponseField name="response" type="object">
  <Expandable title="オブジェクトを切り替え">
    <ResponseField name="id" type="string">
      完了後にファイルに付与される id。
    </ResponseField>

    <ResponseField name="parts" type="array">
      保存されたパート。それぞれ `{ "part", "size", "etag" }` の形式です。
    </ResponseField>

    <ResponseField name="next_part" type="number">
      まだ保存されていない最小のパート番号。
    </ResponseField>

    <ResponseField name="size_so_far" type="number">
      これまでに保存された合計バイト数。
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN' \
    --header 'Authorization: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "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
    }
  }
  ```
</ResponseExample>

### エラー

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