セマンティック ランカーを有効または無効にする
セマンティック ランカーはプレミアム機能であり、使用量に基づいて請求されます。 セマンティック ランカーは、新しい検索サービスを作成したとき既定で無効になりますが、共同作成者の権限を持つユーザーなら誰でも有効化できます。 誰かが誤って有効にするのを防ぐために、管理 REST API を使ってサービス全体で無効にすることができます。
可用性を確認する
お使いのリージョンでセマンティック ランカーを利用できるかどうかを確認するには、Azure AI 検索のリージョン一覧を参照してください。
セマンティック ランカーを有効にする
セマンティック ランカーをサービス レベルで有効にするには、以下の手順に従います。 有効になると、すべてのインデックスで使用できるようになります。 特定のインデックスに対して有効または無効にすることはできません。
Azure portal を開きます。
お使いの検索サービスに移動します。 概要ページで、価格レベルの設定が Basic またはそれ以上であることを確認します。
左側のナビゲーション ウィンドウで、[設定]>[セマンティック ランカー] を選択します。
[無料プラン]または [Standard プラン] を選択します。 無料プランと Standard プランは、いつでも切り替えて使用できます。
Free プランは、1 か月あたり 1,000 件のクエリに制限されています。 無料プランに含まれる最初の 1,000 件のクエリを超えると、クォータを使い果たしたというエラー メッセージが次のセマンティック クエリで表示されます。 クォータを使い果たした後にセマンティック ランク付けを引き続き使用するには、Standard プランにアップグレードする必要があります。
REST API を使ってセマンティック ランカーを無効にする
機能の有効化を解除する場合や、意図しない利用と料金発生を確実に防ぐ必要がある場合は、お使いの検索サービスに対して Create または Update のサービス API を使用することにより、セマンティック ランカーを無効化できます。 この機能を無効にすると、セマンティック クエリ タイプのクエリを含んだ要求はすべて拒否されるようになります。
Management REST API 呼び出しは、Microsoft Entra ID を介して認証されます。 認証を行う方法については、REST API で Azure AI 検索サービスを管理する方法の説明を参照してください。
PATCH https://management.azure.com/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2023-11-01
{
"properties": {
"semanticSearch": "disabled"
}
}
セマンティック ランカーをもう一度有効にするには、semanticSearch を Free (既定値) または Standard に設定して上記の要求をもう一度実行します。