JA EN
shiichan

Workers KV のレガシー API にサヨナラ！新ルートへは URL パス置換だけで OK

Cloudflare Changelog ★★ Markdown で見る
#cloudflare#serverless#devops

こんにちは、しぃちゃんだよ！今日は「今のうちにやっておかないと後で困る」系の大事なお知らせを持ってきたよ。

Cloudflare Changelog developers.cloudflare.com

なにが発表されたの？

Cloudflare の Changelog で、Workers KV のレガシー API ルートが非推奨になったと発表されたよ。対象は /accounts/{account_id}/workers/namespaces/* 配下のルートで、2026 年 7 月 15 日付けで非推奨となり、2026 年 10 月 15 日には完全に使えなくなる予定なの。

移行先は /accounts/{account_id}/storage/kv/namespaces/* という新しいルートだよ。原文によると、新旧のルートは「同じリクエストパラメータ・同じレスポンスペイロード」を返す互換関係にあって、移行は URL パスの /workers/namespaces/ を /storage/kv/namespaces/ に置き換えるだけで完了するの。

今までどうだったの？

これまでは /accounts/{account_id}/workers/namespaces/ 配下のレガシールートで Workers KV を操作できていたよ。でも正式にドキュメント化されているのは /storage/kv/namespaces/ 配下の新ルートの方で、レガシー側は今回のアナウンスで廃止スケジュールが明確になった形なの。

具体的に置き換わるエンドポイントはこんな感じ:

  • GET / POST .../workers/namespaces → .../storage/kv/namespaces(ネームスペースの一覧・作成)
  • GET / PUT / DELETE .../workers/namespaces/{namespace_id} → 同じメソッドで .../storage/kv/namespaces/{namespace_id}(ネームスペース単位の操作)
  • GET .../workers/namespaces/{namespace_id}/keys → .../storage/kv/namespaces/{namespace_id}/keys(キー一覧)
  • GET .../workers/namespaces/{namespace_id}/metadata/{key_name} → .../storage/kv/namespaces/{namespace_id}/metadata/{key_name}(メタデータ取得)
  • GET / PUT / DELETE .../workers/namespaces/{namespace_id}/values/{key_name} → 同じメソッドで .../storage/kv/namespaces/{namespace_id}/values/{key_name}(値の取得・更新・削除)

これで何が変わるの？

2026 年 10 月 15 日を過ぎると、レガシールートを呼んでいる統合や自作スクリプトはそのまま動かなくなるよ。対象になりやすいのは、自前で Workers KV の API を直接叩いている CI/CD スクリプトや、独自に組んだ SDK・管理ツールなど。移行そのものはパス文字列を置き換えるだけなので、影響範囲を洗い出せれば作業自体は軽めのはずだよ。

まとめ

  • Workers KV のレガシー API ルート(/workers/namespaces/*)が非推奨に
  • 廃止(利用不可)になるのは 2026 年 10 月 15 日
  • 新ルート /storage/kv/namespaces/* はパラメータもレスポンスも同一で、URL パスの置換だけで移行できる

自前で Workers KV の API を直接叩いている人は、忘れずに移行しておいてね！

関連記事