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

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. にご相談いただけます。お問い合わせからご連絡ください。
出典
この記事に関連するchot Inc.の支援
chot Inc.は日本初のVercel公式パートナーとして、Next.jsを中心としたWebサイト・Webアプリケーションの開発を支援しています。Vercelの導入・契約・運用の見直しはVercel公式パートナー開発支援で、Next.jsによる新規開発や既存システムからの技術移行はモダンWeb開発で紹介しています。


