# Vercel Blob の TTL 自動削除とは？ttlDays の使い方、課金、注意点

元のページ: <https://chot-inc.com/columns/vercel-blob-ttl-automatic-deletion>

開発 2026.11.18

Vercel Blob で、ファイルに保存期間 (TTL) を付けて自動で削除できるようになりました。Vercel は 2026年11月17日の Changelog で発表しています。書き込むときに `ttlDays` を 1〜730 日の範囲で指定すると、アップロード日から数えてその日数が過ぎたあとに削除されます。エクスポートしたファイルや一時アップロード、セッションの記録のように、これまで cron ジョブなどで消していたファイルがあるなら、その仕組みを置き換えられる可能性があります。TTL を付けると課金が少し増えます。また、期限はアップロード日から数えます。この 2 点を先に理解しておくと、導入するかどうかを判断しやすくなります。

## 何ができるようになったのか

TTL (Time To Live) は、データを残しておく期間のことです。これまで Vercel Blob には、一定期間がたったファイルを自動で消す機能がありませんでした。そのため、古いファイルは自分で一覧を取得し、削除する処理を書く必要がありました。

Changelog によると、`ttlDays` は `put()`、`copy()`、`putImage()`、マルチパートアップロード、署名付きアップロード URL で使えます。SDK リファレンスでは、ほかに `rename()` とクライアントアップロード用のトークンも対応先に挙げています。マルチパートの場合は、`createMultipartUpload()` か `createMultipartUploader()` に渡します。ほかのマルチパート用メソッドに渡しても読まれません。

```
import { put, setTtl, head } from '@vercel/blob';

// アップロードから 7 日後に削除
const blob = await put('exports/report.csv', csv, {
  access: 'private',
  ttlDays: 7,
});

// 30 日に延長 (起点はアップロード日のまま)
await setTtl(blob.url, { ttlDays: 30 });

// TTL を外して無期限に戻す
await setTtl(blob.url, { ttlDays: null });

// 削除予定日を確認
const { expiresAt } = await head(blob.url);
```

すでに保存してあるファイルの TTL は、`setTtl()` で変更や解除ができます。再アップロードは要りません。Changelog によると、一度に指定できる URL は最大 1,000 件です。必要なパッケージは `@vercel/blob` の 2.9.0 で、Changelog にはインストールコマンドとして `npm install @vercel/blob@2.9.0` が載っています。

CLI では、Vercel CLI 65.16.0 以降で `vercel blob put`、`put-image`、`copy`、`presign` に `--ttl-days` を付けられます。既存のファイルには `vercel blob set-ttl` を使い、TTL を外すときは `--clear-ttl` を付けます。CLI のリリースノートでは、65.16.0 の公開日は 2026-11-14 です。

```
vercel blob put report.csv --ttl-days 7
vercel blob set-ttl exports/a.csv exports/b.csv --ttl-days 30
vercel blob set-ttl exports/a.csv --clear-ttl
```

## 削除のタイミングと、誤削除を防ぐための仕様

SDK リファレンスには、運用で気をつけたい仕様がいくつか書かれています。

1 つ目は削除のタイミングです。期限切れの処理は 1 日 1 回、UTC の午前 0 時に行われます。そのため、ファイルは少なくとも `ttlDays` の日数ぶんは残ります。UTC の午前 0 時は日本時間では午前 9 時です。`expiresAt` が過去の日時になったファイルは削除待ちになり、ダッシュボードには **Pending Deletion** と表示されます。実際に消えるのは、たいてい 1 日以内です。つまり TTL は「何日たったら片付ける」ための機能で、決まった時刻にアクセスを止める用途には向きません。期限付きでアクセスさせたいなら、同じドキュメントで案内されている署名付き URL (Vercel Signed URLs) を検討してください。

2 つ目は期限の起点です。TTL を設定した時点ではなく、ファイルをアップロードした時点から数えます。そのため、アップロードから 30 日たったファイルに `setTtl()` で 7 日を設定すると、期限はすでに過ぎています。こうしたファイルは削除待ちになると考えられます。既存のファイルにまとめて TTL を付けるときは、対象がいつアップロードされたかを先に確認してください。TTL で削除されたファイルは、`del()` で消した場合と同じく元に戻せません。

3 つ目は、TTL が引き継がれない場面です。`ttlDays` を付けずに上書きすると、そのファイルの TTL は外れます。`copy()` と `rename()` も、元のファイルの TTL を引き継ぎません。これを利用すると、次のような流れを組めます。まず一時ファイルとして TTL 付きで保存し、ユーザーが確定したら TTL なしで正式なパスへ `copy()` か `rename()` します。確定しなかった一時ファイルは、放っておけば消えます。逆に言えば、上書きやコピーのあとも期限を残したいときは、そのたびに `ttlDays` を指定し直す必要があります。

## expiresAt の返り方は資料によって記述が違う

Changelog には、書き込み結果と `head()` のレスポンスの両方に `expiresAt` が含まれると書かれています。`put()` の戻り値から `expiresAt` を表示するコード例も載っています。一方、SDK リファレンスの自動失効の節には、`head()` は `expiresAt` を返すが、書き込み系のメソッドは返さないと書かれています。2026年11月18日時点で、2 つの記述は食い違っています。削除予定日を確実に知りたい処理では、両方の資料に書かれている `head()` で取得するのが無難です。

## 課金への影響

料金ページによると、TTL を設定すると、書き込み自体の課金に加えて Advanced Operation (アップロードや一覧取得などに数えられる操作) が増えます。増える回数は、TTL の 60 日ごとに 1 回です。60 日に満たない端数も 1 回に数えます。1〜60 日なら 1 回、61〜120 日なら 2 回、最大の 730 日なら 13 回です。`setTtl()` の課金はこの TTL 分だけです。TTL の解除と、TTL による削除は無料です。TTL に関する操作の回数は、Observability タブの Blob セクションで確認できます。

金額は、料金ページの例で使われている Advanced Operations の単価 $5.00/100 万回 (料金は地域ごとに異なります) で試算できます。月に 10 万ファイルを 7 日の TTL 付きで保存すると、増える操作は 10 万回で、約 $0.50 です。多くの場合、負担は小さいと考えられます。注意したいのは Hobby プランです。Advanced Operations の無料枠は最初の 2,000 回で、超えると Blob が使えなくなり、30 日待つ必要があります。アップロードが多いアプリで長い TTL を付けると、1 ファイルあたりの操作回数が数倍になります。Hobby プランで使う場合は、TTL を必要な長さにとどめてください。

自前で削除処理を書く方法と比べると、ファイルの一覧を取得する `list()` も Advanced Operation に数えられます。削除そのものは無料です。TTL を使えば、定期的に一覧を取って古いファイルを探す処理と、その処理を動かす仕組みが不要になります。費用だけでなく、保守の手間も含めて比べるとよいでしょう。

## 導入を検討すべきケース

向いているのは、保存期間をファイルを作る時点で決められるデータです。Vercel 自身も、セッションの記録、エクスポート、一時アップロードを例に挙げています。AI アプリの会話ログや生成物の一時保存、帳票の書き出し、確定前のアップロード画像なども、同じ考え方で整理できます。

一方、保存期間がユーザーの操作や契約状態で変わるデータは、TTL だけで管理すると漏れが出やすくなります。期限の起点がアップロード日に固定されているからです。データベースで状態を管理し、`setTtl()` でまとめて更新する方法と組み合わせるのが現実的です。なお、公開ストアの場合、TTL で削除したあと CDN のキャッシュがどう扱われるかは、今回確認したページには書かれていませんでした。期限後に確実に配信を止める必要があるなら、事前に確認してください。

保存期間の設計、一時ファイルから正式なファイルへの切り替え、AI アプリが生成するデータの片付け方などで迷ったら、Web サイト制作・フロントエンド開発・AI アプリケーション開発を行う chot Inc. にご相談いただけます。[お問い合わせ](https://chot-inc.com/contact)からご連絡ください。

## 出典

- [Vercel: Vercel Blob が TTL による自動削除に対応](https://vercel.com/changelog/vercel-blob-now-supports-ttls-for-automatic-deletion)
- [Vercel: JS SDK リファレンス (Blob の自動失効)](https://vercel.com/docs/vercel-blob/using-blob-sdk#expire-blobs-automatically)
- [Vercel: Vercel Blob の料金](https://vercel.com/docs/vercel-blob/usage-and-pricing#usage)
- [Vercel: Vercel CLI リリースノート](https://vercel.com/docs/cli/release-notes)

## この記事に関連するchot Inc.の支援

chot Inc.は日本初のVercel公式パートナーとして、Next.jsを中心としたWebサイト・Webアプリケーションの開発を支援しています。Vercelの導入・契約・運用の見直しは[Vercel公式パートナー開発支援](https://chot-inc.com/services/vercel-partner)で、Next.jsによる新規開発や既存システムからの技術移行は[モダンWeb開発](https://chot-inc.com/services/modern-web-development)で紹介しています。

この記事をシェア

## 最新の記事

[セキュリティ 2026.11.18](https://chot-inc.com/columns/karte-unauthorized-access-secret-key-leak-response)

### [KARTE不正アクセスで何が漏れたか　モリサワ・mineoの会員と利用企業が今すべきこと](https://chot-inc.com/columns/karte-unauthorized-access-secret-key-leak-response)

[開発 2026.11.18](https://chot-inc.com/columns/vercel-standard-builds-usage-based-billing-new-teams)

### [Vercel の Standard ビルドが新規チームで従量課金に：費用の目安とビルドマシンの選び方](https://chot-inc.com/columns/vercel-standard-builds-usage-based-billing-new-teams)

[開発 2026.11.18](https://chot-inc.com/columns/vercel-native-lint-typecheck-deployment-checks-deprecation)

### [VercelのLint・TypecheckネイティブDeployment Checksが廃止へ：2026年11月30日までの移行先の選び方](https://chot-inc.com/columns/vercel-native-lint-typecheck-deployment-checks-deprecation)

[コラム一覧](https://chot-inc.com/columns)
