スキルのリセット (REST API のプレビュー)
適用対象: 2023-07-01-Preview、2021-04-30-Preview、2020-06-30-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 | 必須。 現在のプレビュー バージョンは です 2023-07-01-Preview。 その他 のバージョンについては、「API のバージョン 」を参照してください。 |
要求ヘッダー
次の表では、必須と省略可能の要求ヘッダーについて説明します。
| フィールド | 説明 |
|---|---|
| Content-Type | 必須。 これを application/json |
| api-key | Azure ロールを使用していて、要求にベアラー トークンが指定されている場合は省略可能。それ以外の場合はキーが必要です。 api-key は、検索サービスに対する要求を認証する一意のシステム生成文字列です。 リセット要求には、(クエリ キーではなく) 管理キーに設定されたヘッダーを含める api-key 必要があります。 詳細については、「 キー認証を使用して Azure AI Search に接続 する」を参照してください。 |
要求本文
要求の本文はスキル名の配列です。
{
"skillNames" : ["<SKILL-1>", "SKILL-n"]
}
Response
状態コード: 応答の成功に対して「204 コンテンツがありません」が返されます。