DocsDigest
一覧へLanguage: EN
OpenAICloudflare Developer Platform2026/07/15 0:00

KV - Deprecate legacy Workers KV namespace API routes

要点だけを先に読めるように短く再構成したセクションです。

元記事
OpenAIClaude

Quick Digest

要約

要点だけを先に読めるように短く再構成したセクションです。

openaijamodel: gpt-5-mini-2025-08-07

Workers KV の旧名前空間 API ルート廃止

cloudflareworkerskvapideprecationnamespaces

Key Points

  • 旧ルート廃止
  • パスを直接置換
  • 停止日: 2026-10-15

Summary

Cloudflare は 2026-07-15 に Workers KV の旧 API ルート（/accounts/{account_id}/workers/namespaces/*）を非推奨としました。旧ルートは 2026-10-15 に動作を停止します。移行先はドキュメント化された新ルート（/accounts/{account_id}/storage/kv/namespaces/*）で、リクエストパラメータやレスポンスは互換です。エンジニアは該当する URL を締切日までに置換してください。

Key Points

  • 重要日程:
    • 非推奨開始: 2026-07-15
    • 動作停止: 2026-10-15
  • 対応内容: 旧パスを新パスへ直接置換するだけ（リクエスト/レスポンスは同一）
  • 例（そのまま置換可能）:
    • GET / POST /accounts/{account_id}/workers/namespaces → /accounts/{account_id}/storage/kv/namespaces
    • GET, PUT, DELETE /accounts/{account_id}/workers/namespaces/{namespace_id} → /accounts/{account_id}/storage/kv/namespaces/{namespace_id}
    • GET /accounts/{account_id}/workers/namespaces/{namespace_id}/keys → /accounts/{account_id}/storage/kv/namespaces/{namespace_id}/keys
    • GET /accounts/{account_id}/workers/namespaces/{namespace_id}/metadata/{key_name} → /accounts/{account_id}/storage/kv/namespaces/{namespace_id}/metadata/{key_name}
    • GET, PUT, DELETE /accounts/{account_id}/workers/namespaces/{namespace_id}/values/{key_name} → /accounts/{account_id}/storage/kv/namespaces/{namespace_id}/values/{key_name}
  • 推奨作業:
    • CI/デプロイ、SDK、統合テスト、ライブラリの URL を一括置換
    • 本番移行前にエンドツーエンドテストを実行

参考: パスの単純置換で対応可能なため、影響は小さいが 2026-10-15 以降は旧ルートが利用できなくなります。

Full Translation

翻訳

原文の流れを保ったまま読める翻訳セクションです。

openaijamodel: gpt-5-mini-2025-08-07

KV - レガシー Workers KV ネームスペース API ルートの廃止

概要

レガシーの Workers KV API ルート（/accounts/{account_id}/workers/namespaces/*）は 2026年7月15日 をもって非推奨となり、2026年10月15日 に機能しなくなります。これまでに、ドキュメント化された Workers KV API ルート（/accounts/{account_id}/storage/kv/namespaces/*）へ移行してください。

レガシーと置換後のルートは相互に置き換え可能で、同じリクエストパラメータを受け取り、同じレスポンスペイロードを返します。移行は URL パスの置換で完了します：/workers/namespaces/ を /storage/kv/namespaces/ に更新してください。

対応方法

  • /accounts/{account_id}/workers/namespaces/ 以下のルートを呼び出しているすべての統合（integration）を、同等の /accounts/{account_id}/storage/kv/namespaces/ に更新してください。
  • 移行は直接の URL パス置換です。リクエストパラメータとレスポンスペイロードは同一です。

ルート対応表

  • GET および POST /accounts/{account_id}/workers/namespaces → GET および POST /accounts/{account_id}/storage/kv/namespaces
  • GET, PUT, DELETE /accounts/{account_id}/workers/namespaces/{namespace_id} → GET, PUT, DELETE /accounts/{account_id}/storage/kv/namespaces/{namespace_id}
  • GET /accounts/{account_id}/workers/namespaces/{namespace_id}/keys → GET /accounts/{account_id}/storage/kv/namespaces/{namespace_id}/keys
  • GET /accounts/{account_id}/workers/namespaces/{namespace_id}/metadata/{key_name} → GET /accounts/{account_id}/storage/kv/namespaces/{namespace_id}/metadata/{key_name}
  • GET, PUT, DELETE /accounts/{account_id}/workers/namespaces/{namespace_id}/values/{key_name} → GET, PUT, DELETE /accounts/{account_id}/storage/kv/namespaces/{namespace_id}/values/{key_name}

参照

  • 非推奨スケジュールの詳細については API deprecations を参照してください。