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

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

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

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