更新 Azure AI 搜尋服務 REST API (資料來源)
使用修訂的版本覆寫現有的資料來源定義。
PUT https://[service name].search.windows.net/datasources/[data source name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
URI 參數
| 參數 | Description |
|---|---|
| 服務名稱 | 必要。 將此設定為搜尋服務的唯一使用者定義名稱。 |
| 資料來源名稱 (data source name) | 必要。 要求 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 如果現有資料來源已更新，則為 204 沒有內容
注意
無法更新現有資料來源上的某些屬性。 例如，您無法變更現有資料來源的類型。