Cloudflare Python SDK が v5.0.0-beta.1 に進化！新リソース満載、でも破壊的変更には要注意だよ

こんにちは、しぃちゃんだよ！ 今日は Cloudflare の SDK 周りでちょっと大きな動きを見つけたから、さっそく紹介するね。Python で Cloudflare API を触っている人は要チェックの内容だよ。

Cloudflare Changelog developers.cloudflare.com

なにが発表されたの？

Cloudflare の Changelog によると、2026 年 2 月 13 日に Python 向け公式 SDK「cloudflare-python」の新バージョン v5.0.0-beta.1 が公開された。公式の注記には「v5.0.0-beta.1 is in Beta and we are still testing it for stability」とあり、まだ正式版ではなくテスト中のベータリリースという位置づけになっている。直前の安定版 v4.3.1 からの全変更点は、GitHub の比較ページにまとめて公開されているよ。

今までどうだったの？

cloudflare-python は Cloudflare API の OpenAPI 定義から自動生成されている SDK。つまり、元になる OpenAPI スキーマや、それを読み込んで SDK を組み立てるコード生成ツール(codegen)が変われば、その影響が SDK 側にもそのまま波及する仕組みになっている。公式のアナウンスでも、今回の破壊的変更の大半は「OpenAPI スキーマの精度向上」が原因だとはっきり書かれていて、正確さを上げるための変更が結果的に既存コードを壊してしまうケースが多かったみたい。これまで積み重なってきた定義のズレが、v5 系でまとめて解消された形なのかも。

これで何が変わるの？

今回のベータでいちばん目を引くのは、新しく追加されたリソースの多さ。数えてみたら 48 個もの新規リソースが入っていたよ。代表的なところだと、こんなジャンルが増えている。

• aisearch 系 — AI 検索機能とそのインスタンス・トークン管理
• aigateway.dynamicrouting / aigateway.providerconfigs — AI Gateway の動的ルーティングとプロバイダー設定
• brandprotection 系 — ブランド保護のロゴ検出・マッチ結果管理
• pipelines 系 — データパイプラインとシンク・ストリームの設定
• r2datacatalog 系 — R2 Data Catalog の名前空間や認証情報の管理
• realtimekit 系 — リアルタイム配信・会議・録画などの一式
• tokenvalidation 系 — トークン検証の設定とルール
• workers.beta — Workers のベータ機能

さらに acm.totaltls、d1.database、radar.bgp、zerotrust.networks など、既存の 11 個のリソースにも新しいエンドポイントが追加されていて、既存ユーザーにもアップグレードの価値がありそう。Python から Cloudflare の各種サービスを触っている開発者にとっては、これまで SDK 経由でできなかった操作が一気にできるようになる形だね。

深く潜ってみよう

ただし今回のリリースで一番注意したいのが、タイトルにもある破壊的変更。以下の 15 個のリソースで、破壊的変更が入っているよ。

• abusereports
• acm.totaltls
• apigateway.configurations
• cloudforceone.threatevents
• d1.database
• intel.indicatorfeeds
• logpush.edge
• origintlsclientauth.hostnames
• queues.consumers
• radar.bgp
• rulesets.rules
• schemavalidation.schemas
• snippets
• zerotrust.dlp
• zerotrust.networks

公式は「アップグレード前に必ずマイグレーションガイドと変更点一覧に目を通してほしい」と念押ししていて、環境によっては上流・下流の処理に影響が出る可能性があるとも書かれている(v5 Migration Guide)。まだ Changelog に載っていない変更もありうるそうなので、気になった人は GitHub の Issue で報告してほしいとのこと。

このほか、細かな修正もいろいろ入っているよ。

• 型まわり: Pyright が SequenceNotStr 内の TypedDict を正しく推論できるように改善、Pydantic 2.8.0 より前のバージョンとの互換性も確保
• リクエスト/レスポンス処理: multipart/form-data と JSON を同時に送るケースの修正、デフォルト値が omit 指定のヘッダーを送らないように修正、GET リクエストで不要な Content-Type ヘッダーを送らないように
• パース処理: ネストした discriminated union の解析修正、余分なフィールドの型解釈修正、空のメタデータを無視、リソース名の単数形変換ルールの更新

まとめ

• Cloudflare の公式 Python SDK が v5.0.0-beta.1 としてベータ公開された
• 48 個の新規リソースと、既存 11 リソースへの新エンドポイント追加で扱える範囲がぐっと広がった
• 一方で 15 個のリソースに破壊的変更があり、アップグレード前はマイグレーションガイドの確認が必須
• 型推論やリクエスト処理まわりの地道な修正も多数含まれている

Python で Cloudflare の API を組み込んでいるエンジニア、特に CI/CD やインフラ自動化のスクリプトで cloudflare-python を使っている人は、このベータで自分のコードに影響が出ないか早めに確認しておくのがおすすめだよ。