(Azure AI 搜尋服務 REST API) 更新索引子

  • 發行項

您可以使用 HTTP PUT 要求來更新現有的索引子定義。 指定要在要求 URI 上更新的索引子名稱：

PUT https://[service name].search.windows.net/indexers/[indexer name]?api-version=[api-version]  
    Content-Type: application/json  
    api-key: [admin key]

更新索引子定義不會自動執行，但根據您的修改和相關聯的資料來源，可能需要重設並重新執行。

URI 參數

參數 Description
服務名稱 必要。 將此設定為搜尋服務的唯一使用者定義名稱。
索引子名稱 必要。 要求 URI 指定要更新的索引子名稱。
api-version 必要。 目前的穩定版本是 api-version=2020-06-30 。 如需更多版本，請參閱 API 版本 。

要求標頭

下表說明必要及選用的要求標頭。

欄位 Description
Content-Type 必要。 請設為 application/json
api-key 如果您使用 Azure 角色 ，並在要求上提供持有人權杖，則為選擇性，否則需要金鑰。 API 金鑰是唯一的系統產生字串，可驗證對搜尋服務的要求。 更新要求必須包含 api-key 設定為系統管理員金鑰的標頭 (，而不是查詢金鑰) 。 如需詳細資訊，請參閱 使用金鑰驗證連線到 Azure AI 搜尋 服務。

要求本文

要求本文語法與 建立索引子相同。

更新現有的索引子時，整個定義會取代為要求主體的內容。 一般而言，用於更新的最佳模式是使用 GET 擷取索引子定義、加以修改，然後使用 PUT 進行更新。

回應

要求成功：如果已建立新的索引子，會顯示「201 已建立」；如果現有索引子已更新，則會顯示「204 沒有內容」。

另請參閱