Uppgradera till det senaste REST-API:et i Azure AI-sökning

Använd den här artikeln om du vill migrera till nyare versioner av REST-API:er för söktjänsten och REST-API:er för sökhantering för dataplans- och kontrollplansåtgärder .

Här är de senaste versionerna av REST-API:erna:

Uppgraderingsinstruktioner fokuserar på kodändringar som tar dig igenom icke-bakåtkompatibla ändringar från tidigare versioner så att befintlig kod körs på samma sätt som tidigare, men på den nyare API-versionen. När koden är i arbetsordning kan du bestämma om du vill använda nyare funktioner. Mer information om nya funktioner finns i Vad är nytt i Azure AI-sökning.

Vi rekommenderar att du uppgraderar API-versioner i följd och arbetar igenom varje version tills du kommer till den senaste.

2023-07-01-preview var det första REST-API:et för vektorstöd. Använd inte den här API-versionen. Det är nu inaktuellt och du bör migrera till antingen stabila eller nyare REST API:er för förhandsversion omedelbart.

När du ska uppgradera

Azure AI-sökning bryter bakåtkompatibiliteten som en sista utväg. Uppgradering krävs när:

• Koden refererar till en avvecklad eller icke-stödd API-version och kan påverkas av en eller flera icke-bakåtkompatibla ändringar.

• Koden misslyckas när okända egenskaper returneras i ett API-svar. Som bästa praxis bör ditt program ignorera egenskaper som det inte förstår.

• Koden bevarar API-begäranden och försöker skicka dem till den nya API-versionen igen. Detta kan till exempel inträffa om ditt program bevarar fortsättningstoken som returneras från sök-API:et (mer @search.nextPageParameters information finns i sök-API-referensen).

Så här uppgraderar du

1. Om du uppgraderar en dataplansversion läser du vad som har släppts i den nya API-versionen.

2. Uppdatera parametern api-version , som anges i begärandehuvudet, till en nyare version.

   I programkoden som gör direkta anrop till REST-API:erna söker du efter alla instanser av den befintliga versionen och ersätter den sedan med den nya versionen. Mer information om hur du strukturerar ett REST-anrop finns i Snabbstart: Fulltextsökning med REST.

   Om du använder en Azure SDKs är varje paket inriktat på en viss version av REST-API:et. Om du vill ta reda på vilken REST API-version ditt paket stöder läser du dess ändringslogg. Uppdatera till den senaste paketversionen för att få åtkomst till de senaste funktionerna och API-förbättringarna.

3. Om du uppgraderar en dataplansversion granskar du de brytpunktsförändringar som beskrivs i den här artikeln och använder lösningarna. Börja med den version som används av koden och lös eventuella icke-bakåtkompatibla ändringar för varje nyare API-version tills du kommer till den senaste stabila versionen eller förhandsversionen.

Icke-bakåtkompatibla ändringar

Följande brytförändringar gäller för dataprocesser.

Icke-bakåtkompatibla ändringar för agentdriven hämtning

2026-04-01 är den första stabila REST API-versionen för agentisk hämtning. Den introducerar följande icke-bakåtkompatibla ändringar från 2025-11-01-preview:

• Svarssyntes, frågeplanering och konfigurerbar resonemangsinsats tas bort. Hämtning returnerar endast extraktivt, jordat innehåll.

• Formen för att hämta begäran ändras: messages ersätts av intentsoch flera parametrar har bytt namn eller tagits bort.

• Behörighetsfiltrering på dokumentnivå för blob- och OneLake-kunskapskällor stöds inte.

En fullständig lista över ändringar och migreringssteg på egenskapsnivå finns i Migrera din agentiska hämtningskod.

Brytförändringar för kunskapsagenter

Kunskapsagenter introducerades i 2025-05-01-preview. 2025-08-01-preview I targetIndexesersattes med ett nytt kunskapskällaobjekt och defaultMaxDocsForReranker ersattes med andra API:er. Fler icke-bakåtkompatibla ändringar introducerades i 2025-11-01-preview.

En fullständig lista över ändringar och migreringssteg på egenskapsnivå finns i Migrera din agentiska hämtningskod.

Brytande ändringar för klientkod som läser anslutningsinformation

Gäller från och med 29 mars 2024 och gäller för alla REST-API:er som stöds:

• GET Skillset, GET Index och GET Indexer returnerar inte längre nycklar eller anslutningsegenskaper i ett svar. Det här är en brytande ändring om du har nedströmskod som läser nycklar eller anslutningar (känslig information) från ett GET-svar.

• Om du behöver hämta administratörs- eller fråge-API-nycklar för söktjänsten använder du REST-API:erna för sökhantering.

• Om du behöver hämta anslutningssträngar för en annan Azure resurs, till exempel Azure Storage eller Azure Cosmos DB, använder du API:erna för den resursen och publicerade vägledning för att hämta informationen.

Oförenliga ändringar för semantisk rankningsalgoritm

Semantisk ranker blev allmänt tillgänglig i 2023-11-01. Det här är de icke-bakåtkompatibla ändringarna från tidigare versioner:

• I alla versioner efter 2020-06-01-preview: semanticConfiguration ersätts searchFields som mekanism för att ange vilka fält som ska användas för L2-rangordning.

• För alla API-versioner gjorde uppdateringar den 14 juli 2023 till de Microsoft-värdbaserade semantiska modellerna semantiska rankerspråksagnostiska, vilket effektivt inaktiverade egenskapen queryLanguage. Det finns ingen "icke-bakåtkompatibel ändring" i koden, men egenskapen ignoreras.

Se Migrera från förhandsversion för att överföra koden till att använda semanticConfiguration.

Uppgraderingar av dataplan

Uppgraderingsvägledningen förutsätter uppgradering från den senaste tidigare versionen. Om koden baseras på en gammal API-version rekommenderar vi att du uppgraderar genom varje efterföljande version för att komma till den senaste versionen.

Uppgradera till 2026-04-01

2026-04-01 är den senaste stabila REST API-versionen. Den främjar självständig hämtning, val av kunskapskällor samt flera färdigheter och funktioner för allmänt tillgänglighet.

Innan uppgradering, kontrollera om någon av följande icke-bakåtkompatibla 2026-04-01 ändringar gäller för din kod:

• Sex egenskaper tas bort från kunskapsdefinitionen för GenAI Prompt : httpMethod, timeout, batchSize, degreeOfParallelism, httpHeadersoch authResourceId. Ta bort de här egenskaperna innan du uppgraderar. Definitioner som fortfarande innehåller dessa egenskaper returnerar ett 400 Bad Request fel.

• Agentisk hämtning kräver nu ett eget faktureringssamtycke. Om du har semanticSearch=standardför närvarande måste du uttryckligen ange knowledgeRetrieval=standard innan du uppgraderar. Mer information finns i Aktivera eller inaktivera agentbaserad hämtningsfakturering.

• Om din agentiska hämtningskod riktar sig mot 2025-11-01-preview, så tar 2026-04-01 bort flera förhandsgranskningsfunktioner och standardiserar hämtning kring intentioner, indata, extraherande utdata och minimalt resonemang. Mer information finns i Migrera din agentbaserade hämtningskod.

För alla andra befintliga API:er finns det inga beteendeändringar. Du kan växla i den nya API-versionen och koden körs på samma sätt som tidigare.

Uppgradera till 2025-11-01-preview

2025-11-01-preview introducerar följande icke-bakåtkompatibla ändringar i agentisk hämtning som implementeras i 2025-08-01-preview:

• agents Ersätter med knowledgebases. Flera egenskaper relaterade till kunskapskällor flyttades från kunskapsbasdefinitionen och till åtgärden hämta.

• Egenskaper för kunskapskällor omstruktureras för att implementera nytt objekt ingestionParameters för kunskapskällor som genererar en indexerarpipeline.

En fullständig lista över ändringar och migreringssteg på egenskapsnivå finns i Migrera din agentiska hämtningskod.

För alla andra befintliga API:er finns det inga beteendeändringar. Du kan växla i den nya API-versionen och koden körs på samma sätt som tidigare.

Uppgradera till 2025-09-01

2025-09-01 är en stabil REST API-version som lägger till allmän tillgänglighet för OneLake-indexeraren, dokumentlayoutfärdigheten och andra API:er.

Det finns inga ändringar som bryter bakåtkompatibilitet om du uppgraderar från 2024-07-01 och inte använder några förhandsgranskningsfunktioner. Om du vill använda den nya stabila versionen ändrar du API-versionen och testar koden.

Uppgradera till 2025-08-01-preview

2025-08-01-preview introducerar följande icke-bakåtkompatibla ändringar i kunskapsagenter som skapats med hjälp av 2025-05-01-preview:

• targetIndexes Ersätter med knowledgeSources.
• Tar bort defaultMaxDocsForReranker utan ersättning.

I annat fall sker inga beteendeändringar på befintliga API:er. Du kan växla i den nya API-versionen och koden körs på samma sätt som tidigare.

Uppgradera till 2025-05-01-preview

2025-05-01-preview innehåller nya funktioner, men det finns inga beteendeändringar på befintliga API:er. Du kan växla i den nya API-versionen och koden körs på samma sätt som tidigare.

Uppgradera till 2025-03-01-preview

2025-03-01-preview innehåller nya funktioner, men det finns inga beteendeändringar på befintliga API:er. Du kan växla i den nya API-versionen och koden körs på samma sätt som tidigare.

Uppgradera till 2024-11-01-preview

2024-11-01-preview frågeomskrivning, dokumentlayoutskicklighet, nyckelfri fakturering för skicklighetsbearbetning, Markdown-parsningsläge och omvärderingsalternativ för komprimerade vektorer.

Om du uppgraderar från 2024-09-01-previewkan du växla i den nya API-versionen och koden körs på samma sätt som tidigare.

Den nya versionen introducerar dock syntaxändringar i vectorSearch.compressions:

• rerankWithOriginalVectors Ersätter medenableRescoring
• Flyttar defaultOversampling till ett nytt rescoringOptions egenskapsobjekt

Bakåtkompatibilitet bevaras på grund av en intern API-mappning, men vi rekommenderar att du ändrar syntaxen om du använder den nya förhandsversionen. En jämförelse av syntaxen finns i Komprimera vektorer med hjälp av skalär eller binär kvantisering.

Uppgradera till 2024-09-01-preview

2024-09-01-preview lägger till Matryoshka Representation Learning-komprimering (MRL) för textinbäddningsmodeller-3, målinriktad vektorfiltrering för hybridfrågor, vektorunderpoängsdetaljer för felsökning och tokenchunkning för Textdelningsfärdighet.

Om du uppgraderar från 2024-05-01-previewkan du växla i den nya API-versionen och koden körs på samma sätt som tidigare.

Uppgradera till 2024-07-01

2024-07-01 är en allmän version. De tidigare förhandsversionsfunktionerna är nu allmänt tillgängliga: integrerad segmentering och vektorisering (kompetens för textdelning, AzureOpenAIEmbedding-färdighet), frågevektoriserare baserat på AzureOpenAIEmbedding, vektorkomprimering (skalär kvantisering, binär kvantisering, lagrad egenskap, smala datatyper).

Det finns inga brytningsändringar om du uppgraderar från 2024-05-01-preview till stabil version. Om du vill använda den nya stabila versionen ändrar du API-versionen och testar koden.

Det finns kompatibilitetsbrytande ändringar om du uppgraderar direkt från 2023-11-01. Följ stegen som beskrivs för varje nyare förhandsversion för att migrera från 2023-11-01 till 2024-07-01.

Uppgradera till 2024-05-01-preview

2024-05-01-preview lägger till en indexerare för Microsoft OneLake, binära vektorer och fler inbäddningsmodeller.

Om du uppgraderar från 2024-03-01-preview, kräver AzureOpenAIEmbedding-färdigheten nu ett modellnamn och dimensionsattribut.

1. Sök i din kodbas efter AzureOpenAIEmbedding-referenser .

2. Ange modelName till "text-embedding-ada-002" och ange dimensions till "1536".

Uppgradera till 2024-03-01-preview

2024-03-01-preview lägger till smala datatyper, skalbar kvantisering och lagringsalternativ för vektorer.

Om du uppgraderar från 2023-10-01-preview, finns det inga ändringar som bryter bakåtkompatibiliteten. Det finns dock en beteendeskillnad: för 2023-11-01 och nyare förhandsversioner har standardinställningen vectorFilterMode ändrats från postfilter till förfilter för filteruttryck.

1. Sök efter referenser i din kodbas vectorFilterMode .

2. Om egenskapen uttryckligen anges krävs ingen åtgärd. Om du förlitade dig på standardvärdet, är det nya standardbeteendet att filtrera innan frågan körs. Om du vill filtrera efter frågan ställer du uttryckligen in vectorFilterMode på postfilter för att behålla det gamla beteendet.

Uppgradera till 2023-11-01

2023-11-01 är en allmän version. De tidigare förhandsversionsfunktionerna är nu allmänt tillgängliga: stöd för semantisk rankning och vektor.

Det finns inga icke-bakåtkompatibla ändringar från 2023-10-01-preview, men det finns flera icke-bakåtkompatibla ändringar från 2023-07-01-preview till 2023-11-01. Mer information finns i Uppgradera från 2023-07-01-preview.

Om du vill använda den nya stabila versionen ändrar du API-versionen och testar koden.

Uppgradera till 2023-10-01-preview

2023-10-01-preview var den första förhandsversionen som lade till inbyggd datasegmentering och vektorisering under indexering och inbyggd frågevektorisering. Den stöder även vektorindexering och frågor från den tidigare versionen.

Om du uppgraderar från den tidigare versionen innehåller nästa avsnitt stegen.

Uppgradera från 2023-07-01-preview

Använd inte den här API-versionen. Den implementerar en vektorfrågassyntax som inte är kompatibel med nyare API-versioner.

2023-07-01-preview är nu inaktuell, så du bör inte basera ny kod på den här versionen, och du bör inte heller uppgradera till den här versionen under några omständigheter. I det här avsnittet beskrivs migreringssökvägen från 2023-07-01-preview till en nyare API-version.

Portaluppgradering för vektorindex

Azure-portalen stöder en uppgraderingssökväg med ett klick för 2023-07-01-preview index. Den identifierar vektorfält och innehåller knappen Migrera .

• Migrationsvägen är från 2023-07-01-preview till 2024-05-01-preview.
• Uppdateringar är begränsade till konfigurationer av vektorfält och vektorsökningsalgoritmer.
• Uppdateringar är enkelriktade. Du kan inte ångra uppgraderingen. När indexet har uppgraderats måste du använda 2024-05-01-preview eller senare för att fråga indexet.

Det finns ingen portalmigrering för uppgradering av vektorfrågesyntax. Se koduppgraderingar för ändringar av frågesyntax.

Innan du väljer Migrera väljer du Redigera JSON för att granska det uppdaterade schemat först. Du bör hitta ett schema som överensstämmer med de ändringar som beskrivs i avsnittet om koduppgradering . Portalmigrering hanterar endast index med en vektorsökningsalgoritmkonfiguration. Den skapar en standardprofil som mappar till vektorsökningsalgoritmen 2023-07-01-preview . Index med flera vektorsökningskonfigurationer kräver manuell migrering.

Koduppgradering för vektorindex och frågor

Stöd för vektorsökning introducerades i Skapa eller uppdatera index (2023-07-01-preview).

Uppgradering från 2023-07-01-preview till en nyare stabil version eller förhandsversion kräver:

• Byta namn på och omstrukturera vektorkonfigurationen i indexet
• Skriva om dina vektorfrågor

Använd anvisningarna i det här avsnittet för att migrera vektorfält, konfiguration och frågor från 2023-07-01-preview.

1. Anropa Hämta index för att hämta den befintliga definitionen.

2. Ändra vektorsökningskonfigurationen. 2023-11-01 och senare versioner introducerar begreppet vektorprofiler som paketering av vektorrelaterade konfigurationer under ett namn. Nyare versioner byter också namn algorithmConfigurations till algorithms.

   • Byt algorithmConfigurations namn till algorithms. Det här är bara ett namnbyte på matrisen. Innehållet är bakåtkompatibelt. Det innebär att dina befintliga HNSW-konfigurationsparametrar kan användas.

   • Lägg till profilesoch ge ett namn och en algoritmkonfiguration för var och en.

   Före migreringen (2023-07-01-preview):

     "vectorSearch": {
       "algorithmConfigurations": [
           {
               "name": "myHnswConfig",
               "kind": "hnsw",
               "hnswParameters": {
                   "m": 4,
                   "efConstruction": 400,
                   "efSearch": 500,
                   "metric": "cosine"
               }
           }
       ]}
   

   Efter migreringen (2023-11-01):

     "vectorSearch": {
       "algorithms": [
         {
           "name": "myHnswConfig",
           "kind": "hnsw",
           "hnswParameters": {
             "m": 4,
             "efConstruction": 400,
             "efSearch": 500,
             "metric": "cosine"
           }
         }
       ],
       "profiles": [
         {
           "name": "myHnswProfile",
           "algorithm": "myHnswConfig"
         }
       ]
     }
   

3. Ändra definitioner för vektorfält och ersätt vectorSearchConfiguration med vectorSearchProfile. Kontrollera att profilnamnet matchar en ny vektorprofildefinition och inte algoritmkonfigurationsnamnet. Andra egenskaper för vektorfält förblir oförändrade. De kan till exempel inte vara filterbara, sorterbara eller fasettbara eller använda analysverktyg eller normaliserare eller synonymkartor.

   Före (2023-07-01-preview):

     {
         "name": "contentVector",
         "type": "Collection(Edm.Single)",
         "key": false,
         "searchable": true,
         "retrievable": true,
         "filterable": false,  
         "sortable": false,  
         "facetable": false,
         "analyzer": "",
         "searchAnalyzer": "",
         "indexAnalyzer": "",
         "normalizer": "",
         "synonymMaps": "", 
         "dimensions": 1536,
         "vectorSearchConfiguration": "myHnswConfig"
     }
   

   Efter (2023-11-01):

     {
       "name": "contentVector",
       "type": "Collection(Edm.Single)",
       "searchable": true,
       "retrievable": true,
       "filterable": false,  
       "sortable": false,  
       "facetable": false,
       "analyzer": "",
       "searchAnalyzer": "",
       "indexAnalyzer": "",
       "normalizer": "",
       "synonymMaps": "", 
       "dimensions": 1536,
       "vectorSearchProfile": "myHnswProfile"
     }
   

4. Anropa Skapa eller uppdatera index för att publicera ändringarna.

5. Ändra Sök POST för att ändra frågesyntaxen. Den här API-ändringen möjliggör stöd för polymorfa vektorfrågetyper.

   • Byt vectors namn till vectorQueries.
   • För varje vektorfråga lägger du till kindoch ställer in den på vector.
   • För varje vektorfråga byter du namn value till vector.
   • Du kan också lägga till vectorFilterMode om du använder filteruttryck. Standardvärdet är förfilter för index som skapats efter 2023-10-01. Index som skapats före det datumet stöder endast postfilter, oavsett hur du ställer in filterläget.

   Före (2023-07-01-preview):

   {
       "search": (this parameter is ignored in vector search),
       "vectors": [
         {
           "value": [
               0.103,
               0.0712,
               0.0852,
               0.1547,
               0.1183
           ],
           "fields": "contentVector",
           "k": 5
         }
       ],
       "select": "title, content, category"
   }
   

   Efter (2023-11-01):

   {
     "search": "(this parameter is ignored in vector search)",
     "vectorQueries": [
       {
         "kind": "vector",
         "vector": [
           0.103,
           0.0712,
           0.0852,
           0.1547,
           0.1183
         ],
         "fields": "contentVector",
         "k": 5
       }
     ],
     "vectorFilterMode": "preFilter",
     "select": "title, content, category"
   }
   

De här stegen slutför migreringen till 2023-11-01 en stabil API-version eller nyare förhandsversioner av API:et.

Uppgradera till 2020-06-30

I den här versionen finns det en brytförändring och flera betydande beteendeskillnader. Allmänt tillgängliga funktioner är:

• Kunskapslager, beständig lagring av berikat innehåll som skapats via kompetensuppsättningar, skapat för nedströmsanalys och bearbetning via andra program. Ett kunskapslager skapas via Azure AI-sökning REST-API:er, men det finns i Azure Storage.

Brytande ändring

Kod som skrivits mot tidigare API-versioner bryter på 2020-06-30 och senare om koden innehåller följande funktioner:

• Alla Edm.Date literaler (ett datum som består av år-månad-dag, till exempel 2020-12-12) i filteruttryck måste följa Edm.DateTimeOffset formatet: 2020-12-12T00:00:00Z. Den här ändringen var nödvändig för att hantera felaktiga eller oväntade frågeresultat på grund av tidszonsskillnader.

Beteendeändringar

• BM25-rangordningsalgoritmen ersätter den tidigare rankningsalgoritmen med nyare teknik. Tjänster som skapats efter 2019 använder den här algoritmen automatiskt. För äldre tjänster måste du ange parametrar för att använda den nya algoritmen.

• Ordnade resultat för null-värden har ändrats i den här versionen, med null-värden som visas först om sorteringen är asc och sist om sorteringen är desc. Om du har skrivit kod för att hantera hur nullvärden sorteras bör du vara medveten om den här ändringen.

Uppgradera till 2019-05-06

Funktioner som blev allmänt tillgängliga i den här API-versionen är:

• Automatisk komplettering är en funktion som kompletterar en delvis angiven termangivelse.
• Komplexa typer ger inbyggt stöd för strukturerade objektdata i sökindex.
• JsonLines parsningsordning, en del av Azure Blob-indexering, skapar ett sökdokument per JSON-entitet som avgränsas med en ny rad.
• AI-berikning ger indexering som använder AI-berikande motorer i Foundry Tools.

Icke-bakåtkompatibla ändringar

Kod som skrivits mot en tidigare API-version bryter på 2019-05-06 och senare om den innehåller följande funktioner:

1. Skriv egenskap för Azure Cosmos DB. För indexerare som riktar in sig på en Azure Cosmos DB för NoSQL API datakälla ändrar du "type": "documentdb" till "type": "cosmosdb".

2. Om indexerarens felhantering innehåller referenser till status egenskapen bör du ta bort den. Vi tog bort status från felsvaret eftersom det inte gav användbar information.

3. Datakällans anslutningssträngar returneras inte längre i svaret. Från API-versioner 2019-05-06 och 2019-05-06-Preview senare returnerar datakällans API inte längre anslutningssträngar som svar på någon REST-åtgärd. I tidigare API-versioner, för datakällor som skapats med POST, returnerade Azure AI-sökning 201 följt av OData-svaret, som innehöll reťazec pripojenia i oformaterad text.

4. Den kognitiva färdigheten för entitetsigenkänning har dragits tillbaka. Om du har anropat kompetensen Namnentitetsigenkänning i koden misslyckas anropet. Ersättningsfunktioner är V3 (Entity Recognition Skill). Följ rekommendationerna i Inaktuella färdigheter för att migrera till en kompetens som stöds.

Uppgradera komplexa typer

API-versionen 2019-05-06 har lagt till formellt stöd för komplexa typer. Om koden implementerade tidigare rekommendationer för komplex typjämförelse i 2017-11-11-Preview eller 2016-09-01-Preview, finns det några nya och ändrade gränser som du måste vara medveten om i version 2019-05-06.

• Gränserna för djupet på underfält och antalet komplexa samlingar per index har sänkts. Om du har skapat index som överskrider dessa gränser med api-versionerna för förhandsversionen misslyckas alla försök att uppdatera eller återskapa dem med hjälp av API-versionen 2019-05-06 . Om du befinner dig i den här situationen måste du göra om schemat så att det passar inom de nya gränserna och sedan återskapa ditt index.

• Det finns en ny gräns som börjar i API-version 2019-05-06 för antalet element i komplexa samlingar per dokument. Om du har skapat index med dokument som överskrider dessa gränser med api-versionerna för förhandsversionen misslyckas alla försök att indexera om dessa data med api-versionen 2019-05-06 . Om du befinner dig i den här situationen måste du minska antalet komplexa samlingselement per dokument innan du indexerar om dina data.

Mer information finns i Service-gränser för Azure AI-sökning.

Uppgradera en gammal komplex typstruktur

Om din kod använder komplexa typer med en av de äldre förhandsversionerna av API:et kanske du använder ett indexdefinitionsformat som ser ut så här:

{
  "name": "hotels",  
  "fields": [
    { "name": "HotelId", "type": "Edm.String", "key": true, "filterable": true },
    { "name": "HotelName", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": true, "facetable": false },
    { "name": "Description", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "en.microsoft" },
    { "name": "Description_fr", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "fr.microsoft" },
    { "name": "Category", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Tags", "type": "Collection(Edm.String)", "searchable": true, "filterable": true, "sortable": false, "facetable": true, "analyzer": "tagsAnalyzer" },
    { "name": "ParkingIncluded", "type": "Edm.Boolean", "filterable": true, "sortable": true, "facetable": true },
    { "name": "LastRenovationDate", "type": "Edm.DateTimeOffset", "filterable": true, "sortable": true, "facetable": true },
    { "name": "Rating", "type": "Edm.Double", "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address", "type": "Edm.ComplexType" },
    { "name": "Address/StreetAddress", "type": "Edm.String", "filterable": false, "sortable": false, "facetable": false, "searchable": true },
    { "name": "Address/City", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address/StateProvince", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address/PostalCode", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address/Country", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Location", "type": "Edm.GeographyPoint", "filterable": true, "sortable": true },
    { "name": "Rooms", "type": "Collection(Edm.ComplexType)" }, 
    { "name": "Rooms/Description", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "en.lucene" },
    { "name": "Rooms/Description_fr", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "fr.lucene" },
    { "name": "Rooms/Type", "type": "Edm.String", "searchable": true },
    { "name": "Rooms/BaseRate", "type": "Edm.Double", "filterable": true, "facetable": true },
    { "name": "Rooms/BedOptions", "type": "Edm.String", "searchable": true },
    { "name": "Rooms/SleepsCount", "type": "Edm.Int32", "filterable": true, "facetable": true },
    { "name": "Rooms/SmokingAllowed", "type": "Edm.Boolean", "filterable": true, "facetable": true },
    { "name": "Rooms/Tags", "type": "Collection(Edm.String)", "searchable": true, "filterable": true, "facetable": true, "analyzer": "tagsAnalyzer" }
  ]
}  

Ett nyare trädliknande format för att definiera indexfält introducerades i API-versionen 2017-11-11-Preview. I det nya formatet har varje komplext fält en fältsamling där dess underfält definieras. I API-version 2019-05-06 används det här nya formatet exklusivt och försök att skapa eller uppdatera ett index med det gamla formatet misslyckas. Om du har skapat index med det gamla formatet måste du använda API-versionen 2017-11-11-Preview för att uppdatera dem till det nya formatet innan de kan hanteras med api-version 2019-05-06.

Du kan uppdatera platta index till det nya formatet med följande steg med hjälp av API-versionen 2017-11-11-Preview:

1. Utför en GET-begäran för att hämta ditt index. Om det redan är i det nya formatet är du klar.

2. Översätt indexet från det platta formatet till det nya formatet. Du måste skriva kod för den här uppgiften eftersom det inte finns någon exempelkod tillgänglig vid tidpunkten för den här skrivning.

3. Utför en PUT-begäran om att uppdatera indexet till det nya formatet. Undvik att ändra annan information om indexet, till exempel sökbarhet/filtrering av fält, eftersom ändringar som påverkar det fysiska uttrycket för det befintliga indexet inte tillåts av API:et för uppdateringsindex.

Uppgraderingar av kontrollplan

Gäller för:2014-07-31-Preview, 2015-02-28, och 2015-08-19

listQueryKeys GET-begäran för äldre API-versioner för sökhantering är nu inaktuell. Vi rekommenderar att du migrerar till den senaste api-versionen för stabila kontrollplan för att använda listQueryKeys POST-begäran.

1. I befintlig kod ändrar du parametern api-version till den senaste versionen (2025-05-01).

2. Omrama begäran från GET till POST:

   POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/listQueryKeys?api-version=2025-05-01
   Authorization: Bearer {{token}}
   

3. Om du använder en Azure SDKs rekommenderar vi att du uppgraderar till den senaste versionen.

Nästa steg

Granska referensdokumentationen för REST API för sökning. Om du stöter på problem kan du be oss om hjälp med Stack Overflow eller kontakta supporten.