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

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

## なにが発表されたの？

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 の[比較ページ](https://github.com/cloudflare/cloudflare-python/compare/v4.3.1...v5.0.0-beta.1)にまとめて公開されているよ。

## 今までどうだったの？

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](https://github.com/cloudflare/cloudflare-python/blob/main/docs/v5-migration-guide.md))。まだ 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 を使っている人は、このベータで自分のコードに影響が出ないか早めに確認しておくのがおすすめだよ。