スキルのリセット (プレビュー REST API)

  • [アーティクル]

: 2023-07-01-Preview に適用されます。 このバージョンはサポートされなくなりました。 新しいバージョンにすぐに アップグレードします。

大事な

2023-07-01-Preview (変更なし)。

2021-04-30-Preview (変更なし)。

2020-06-30-Preview によって API が追加されます。 キャッシュされたエンリッチメント をサポートし、リセット シナリオをサポートします。

スキルのリセット 要求は、次のインデクサー実行で 1 つ以上のスキルを選択的に処理します。 キャッシュが有効になっているインデクサーの場合、インデクサーが検出できないスキル更新の処理を明示的に要求できます。 たとえば、カスタム スキルのリビジョンなど、外部の変更を行う場合は、この API を使用してスキルを再実行できます。 ナレッジ ストアや検索インデックスなどの出力は、キャッシュからの再利用可能なデータと、更新されたスキルごとの新しいコンテンツを使用して更新されます。

要求 URI で更新するスキルセットの名前を指定して、HTTP POST を使用して、既存の スキルセット をリセットできます。

POST https://[servicename].search.windows.net/skillsets/[skillset name]/resetskills?api-version=[api-version]
    Content-Type: application/json
    api-key: [admin key]

URI パラメーター

パラメーター 形容
サービス名 必須。 これを検索サービスの一意のユーザー定義名に設定します。
スキルセット名 必須。 要求 URI は、リセットするスキルセットの名前を指定します。
api-version 必須。 その他のバージョンについては、API のバージョン を参照してください。

要求ヘッダー

次の表では、必須の要求ヘッダーと省略可能な要求ヘッダーについて説明します。

田畑 形容
Content-Type 必須。 これを application/json に設定します
api-key Azure ロール 使用していて、要求にベアラー トークンが提供されている場合は省略可能。それ以外の場合はキーが必要です。 API キーは、検索サービスに対する要求を認証する一意のシステム生成文字列です。 リセット要求には、(クエリ キーではなく) 管理者キーに設定された api-key ヘッダーが含まれている必要があります。 詳細については、「キー認証 を使用して Azure AI Search に接続する」を参照してください。

要求本文

要求の本文は、スキル名の配列です。

{   
    "skillNames" : ["<SKILL-1>", "SKILL-n"]
}

応答

状態コード: 204 正常に応答するためのコンテンツがありません。

関連項目