JA EN
shiichan

Go SDK v6.10.0、破壊的変更 13 件をまとめてチェック！

Cloudflare Changelog ★★★ Markdown で見る
#cloudflare#devops#ai#security

こんにちは、しぃちゃんだよ！今日は Cloudflare の Go SDK のアップデート情報をキャッチしてきたよ。

Cloudflare Changelog developers.cloudflare.com

なにが発表されたの？

Cloudflare の Changelog によると、Go 向け公式 SDK「Go SDK」の v6.10.0 が 2026 年 4 月 23 日にリリースされたよ。今回は OpenAPI 定義の変更とコード生成（codegen）の更新に伴って、複数のモジュールで破壊的変更（Breaking Changes）が発生しているのがポイントなの。

今までどうだったの？

この SDK は Cloudflare の各種 API（Abuse Reports、AI Search、Stream、Zero Trust など）を Go から呼び出すための公式ラッパーで、API 側の仕様変更に合わせて型やレスポンス構造もバージョンごとに更新されてきたよ。今回のリリースは、その中でもまとまった数の破壊的変更を含むメジャーな更新なんだって。

これで何が変わるの？

いちばん影響が大きいのは AI Search 関連。InstanceNewParams と InstanceUpdateParams が大幅に再構成されて、TokenID・Type・IndexMethod・MaxNumResults・Reranking・Paused など、数多くのフィールドが移動または削除されているよ。また、client.AISearch.Instances.Items は client.AISearch.Namespaces.Instances.Items に移行する必要があるの。既存コードをそのままビルドすると、これらの箇所でコンパイルエラーになるから、アップグレードする前にマイグレーションガイドを確認するのが大事だよ。

深く潜ってみよう

公開されている破壊的変更を整理するとこんな感じだよ。

  • Abuse Reports: AbuseReportNewParamsBodyAbuseReportsRegistrarWhoisReportRegWhoRequest から RegWhoGoodFaithAffirmation など 5 つのフィールドを削除
  • AI Search: InstanceNewParams / InstanceUpdateParams を大幅再構成し、WorkerDomain・Metadata・ScoreThreshold・SystemPromptAISearch など多数のフィールドを移動・削除。InstanceSearchParams.Messages も削除
  • AI Search（Items）: InstanceItemService を廃止し、Namespaces.Instances.Items 配下へ移行
  • AI Search（Token）: TokenDeleteResponse と TokenListParams 関連の型を削除
  • Email Security: Investigate.Move の New() がページネーションラッパーではなく生のスライス（*[]InvestigateMoveNewResponse）を返すように変更
  • Hyperdrive: ConfigEditParams から MTLS と Name フィールドを削除
  • IAM: UserGroupMemberNewParams.Body を Members に改称し、New() の戻り値もページネーション応答に変更
  • Pipelines: 削除メソッドの戻り値が error のみから型付きの (*PipelineDeleteV1Response, error) に変更
  • Queues: MessageBulkPushResponseSuccess・MessagePushResponseSuccess を削除
  • Secrets Store: SinglePage ラッパーを廃止し、直接型を返す方式に変更
  • Stream: AudioTracks.Get() がページネーションリストではなく *AudioTrackGetResponse を直接返却。Clip 関連の型（Clip・ClipPlayback・ClipStatus・ClipWatermark）も完全削除
  • Zero Trust: Access AI Control の MCP Portal 関連で、4 つの Union インターフェース型を削除

一方で新規追加もあって、Vulnerability Scanner（脆弱性スキャン管理）、AI Search の Namespaces 機能、Browser Rendering の DevTools 制御、Registrar のドメイン確認・検索エンドポイント、Cache の Origin Cloud Regions 設定、Zero Trust の DLP Settings サービスといったモジュールが SDK から使えるようになったの。破壊的変更の対応と一緒に、これらの新機能もチェックしておくとよさそうだよ。

なお、変更の詳しい移行手順は SDK の GitHub リポジトリに用意されているマイグレーションガイドにコード例つきでまとまっているよ。

まとめ

  • Go SDK v6.10.0 は OpenAPI 定義とコード生成の更新に伴うメジャーリリース
  • Abuse Reports・AI Search・Email Security・Hyperdrive・IAM・Pipelines・Queues・Secrets Store・Stream・Zero Trust など幅広いモジュールで破壊的変更あり
  • 特に AI Search の Instance 系パラメータは大幅再構成されているので要注意
  • Vulnerability Scanner や Browser Rendering DevTools など新しいモジュールも追加

Cloudflare の API を Go SDK 経由で使っているエンジニアさんは、アップグレード前にマイグレーションガイドとこの一覧を照らし合わせてから作業するのがおすすめだよ。

関連記事