Adatforrás frissítése (Azure AI Search REST API)
Felülír egy meglévő adatforrás-definíciót egy módosított verzióval.
PUT https://[service name].search.windows.net/datasources/[data source name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
URI-paraméterek
Paraméter | Leírás |
---|---|
szolgáltatásnév | Kötelező. Állítsa be ezt a keresési szolgáltatás egyedi, felhasználó által definiált nevére. |
adatforrás neve | Kötelező. A kérelem URI-ja megadja a frissíteni kívánt adatforrás nevét. |
api-verzió | Kötelező. A jelenlegi stabil verzió a következő api-version=2020-06-30 : . További verziókért lásd: API-verziók . |
Kérelemfejlécek
Az alábbi táblázat a szükséges és nem kötelező kérésfejléceket ismerteti.
Mezők | Description |
---|---|
Content-Type | Kötelező. Állítsa a következőre: application/json |
api-key | Nem kötelező , ha Azure-szerepköröket használ, és egy tulajdonosi jogkivonatot ad meg a kéréshez, ellenkező esetben kulcsra van szükség. Az API-kulcs egy egyedi, rendszer által generált sztring, amely hitelesíti a kérést a keresési szolgáltatásnak. A frissítési kérelmeknek tartalmazniuk kell egy api-key , a rendszergazdai kulcsra beállított fejlécet (a lekérdezési kulcs helyett). A részletekért lásd: Csatlakozás az Azure AI Search szolgáltatáshoz kulcshitelesítés használatával . |
Kérelem törzse
A kérelemtörzs szintaxisa megegyezik az Adatforrás létrehozása szintaxisával.
Meglévő adatforrás frissítésekor a rendszer a teljes definíciót a kérelemtörzs tartalmára cseréli. A frissítésekhez általában az a legjobb módszer, ha lekéri az adatforrás definícióját egy GET paranccsal, módosítja, majd a PUT paranccsal frissíti.
Reagálás
Sikeres kérés esetén: 201 Új adatforrás létrehozása esetén létrehozva, 204 Nincs tartalom, ha egy meglévő adatforrást frissítettek
Megjegyzés
Egyes tulajdonságok nem frissíthetők egy meglévő adatforráson. Egy meglévő adatforrás típusát például nem módosíthatja.