Skip to main content
ワークスペース全体のルーティング既定値を変えずに、特定のプロバイダールートを優先したい場合に使います。

目的

  • 優先順にプロバイダーを試す。
  • リクエストを承認済みプロバイダーの一部に限定する。
  • プリセットを編集せずに、プロバイダーを一時的に除外する。

1. プロバイダーを指定した順序で試す

優先するルートの順序が決まっている場合は、provider.order を使います。
指定したプロバイダーが候補の先頭に並び、その後に他の利用可能な候補が続きます。

2. リクエストを固定されたプロバイダー群に限定する

リクエストを少数の許可リスト内に限定する必要がある場合は、provider.only を使います。
リクエストを指定したプロバイダー群に限定したうえで、その中に選択した順位付け方法を適用します。

3. プロバイダーを候補から除外する

リクエスト単位または短期間の展開でプロバイダーを除外する場合は、provider.ignore を使います。
次のような場合に便利です。
  • あるプロバイダーの状態が悪い
  • 別のプロバイダールートを検証している
  • プリセットを編集せずにルーティング結果を比較したい

4. 各設定を慎重に組み合わせる

これらの設定は組み合わせられますが、目的は明確にしてください。
  • order で優先順位を示す
  • only で候補を限定する
  • ignore でプロバイダーを除外する
実用的な組み合わせ例:
  • only でリクエストを google-vertex と google-vertex-eu に限定する
  • order で google-vertex-eu を優先する
  • sort: "latency" で許可された候補を順位付けする

5. これらの設定をプリセットに移すタイミング

同じプロバイダールールが複数のサービスで使われる場合は、リクエストごとに複製せず、プリセットに移します。 次のような場合はリクエスト単位のルーティングを使います。
  • 一時的
  • 呼び出し元固有
  • 1 つのユーザーフローに関連する

関連ガイド

最終更新日 2026年10月2日