> ## 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.

# CLI で Blob Storage のファイルを管理する

> squarecloud blob で Square Cloud Blob Storage のファイルを一覧、アップロード、削除し、リンクを取得して、プランのストレージの使用量を確認します。

`squarecloud blob` は、[Blob Storage](https://docs.squarecloud.app/ja/services/blob.md) のファイルを管理します。ファイルは ID で識別され、ID は `blob list` と `blob upload` が表示します。

コマンドには、`blob:read` と `blob:write` の[スコープ](https://docs.squarecloud.app/ja/blob-reference/authentication.md#スコープ)を持つ API キーが必要です。ブラウザでのログインでは両方が要求されます。バージョン 3.2.0 より前のブラウザでのログインで発行されたキーにはこれらがないため、最初の Blob コマンドで `squarecloud auth login` をもう一度実行するよう求められます。`SQUARECLOUD_API_KEY` のキーにも両方のスコープが必要です。

## `squarecloud blob list`

```bash 使い方 theme={"system"}
squarecloud blob list [prefix] [--json]
```

すべてのファイル、または `prefix` 配下のファイルだけについて、ID、サイズ、作成日時、URL を表示します。プライベートファイルでは、URL の代わりに `(private)` と表示されます。

```bash theme={"system"}
squarecloud blob list avatars/
# Only the files under avatars/.
```

`--json` を付けると、ファイルを JSON 配列で出力します。

## `squarecloud blob upload`

```bash 使い方 theme={"system"}
squarecloud blob upload <file> [--name <name>] [--private] [--json]
```

| フラグ | 説明 |
| - | - |
| `--name <name>` | 拡張子を除いたこの名前でファイルを保存します。デフォルトでは、拡張子を除いたファイル名が名前になります。 |
| `--private` | ファイルをプライベートとして保存します。公開 URL はなく、一時リンクからのみアクセスできます。 |

ファイルを 1 つアップロードし、その ID と URL を表示します。サービスはファイルの拡張子を保持します。デフォルトの名前では、サービスが受け付けない文字は `_` に置き換えられます。フォルダを送るには、先に [`squarecloud zip`](https://docs.squarecloud.app/ja/cli-reference/deploy#squarecloud-zip) で zip にしてください。

```bash theme={"system"}
squarecloud blob upload ./video.mp4
```

```bash 出力 theme={"system"}
Uploading video.mp4 (1.20 GB)...
Sent part 77 of 77
✓ Uploaded as <ID>
  <URL>
```

* **大きなファイル:** 90 MiB を超えるファイルは、サービスから送られる制限に基づいたサイズのパートに分けて、6 個ずつアップロードされます。進行状況は stderr に出力されるため、stdout には結果だけが出力されます。
* **失敗:** 失敗またはキャンセル（`Ctrl+C`）したアップロードは中止されるため、開いているアップロードの枠を占有しません。リトライされるのは読み取りとパートだけで、レート制限は決してリトライされません。
* **プライベートファイル:** URL の代わりに、一時リンクを作成するコマンド [`blob url`](#squarecloud-blob-url) が表示されます。

`--json` を付けると、stdout には保存されたファイル（ID、公開範囲、URL、サイズ、パートに分けたアップロードの場合はパート数）だけが JSON で出力されます。

## `squarecloud blob url`

```bash 使い方 theme={"system"}
squarecloud blob url <id> [--json]
```

ファイルのダウンロードリンクを表示します。公開 URL、またはプライベートファイルの場合は一時リンクです。stdout にはリンクだけが出力されるため、`$(...)` の中でも使えます。一時リンクの場合、CLI はその有効期限を stderr に表示します。

```bash theme={"system"}
curl -o report.pdf "$(squarecloud blob url <ID>)"
# Downloads a file, public or private.
```

`--json` を付けると、リンクとその有効期限、公開範囲、サイズ、コンテンツタイプを出力します。

## `squarecloud blob delete`

```bash 使い方 theme={"system"}
squarecloud blob delete <id> [-y]
```

| フラグ | 説明 |
| - | - |
| `-y`、`--yes` | 確認プロンプトをスキップします。 |

> [!WARNING]
>
> ファイルの削除は恒久的です。ゴミ箱はありません。

削除する前に `Delete <ID> for good? There is no trash [y/N]` と確認します。`delete` には JSON 出力はありません。

## `squarecloud blob stats`

```bash 使い方 theme={"system"}
squarecloud blob stats [--json]
```

保存しているファイルの数と、それらがプランのストレージをどれだけ使っているかを表示します。

```bash 出力 theme={"system"}
Files: <count>
Storage: <used> used of the <included> in your plan
```

`--json` を付けると、使用状況の記録全体を JSON で出力します。

## 関連項目

| コマンド | API | Blob SDK |
| - | - | - |
| `list` | [`GET /v1/objects`](https://docs.squarecloud.app/ja/blob-reference/endpoint/list) | [`blob.list()`](https://docs.squarecloud.app/ja/sdks/blob/objects#一覧) |
| `upload` | [`POST /v1/objects`](https://docs.squarecloud.app/ja/blob-reference/endpoint/post)、[チャンクアップロード](https://docs.squarecloud.app/ja/blob-reference/endpoint/chunked-init.md) | [`blob.put()`](https://docs.squarecloud.app/ja/sdks/blob/uploads) |
| `url` | [`GET /v1/objects/download`](https://docs.squarecloud.app/ja/blob-reference/endpoint/download) | [`blob.downloadUrl()`](https://docs.squarecloud.app/ja/sdks/blob/objects#ダウンロードリンク) |
| `delete` | [`DELETE /v1/objects`](https://docs.squarecloud.app/ja/blob-reference/endpoint/delete) | [`blob.delete()`](https://docs.squarecloud.app/ja/sdks/blob/objects#削除) |
| `stats` | [`GET /v1/account/stats`](https://docs.squarecloud.app/ja/blob-reference/endpoint/stats) | [`blob.stats()`](https://docs.squarecloud.app/ja/sdks/blob/rules_and_stats#統計) |

自分のコードから Blob Storage を使うには、[Blob SDK](https://docs.squarecloud.app/ja/sdks/blob/client.md) から始めてください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.