Documents - Suggest Post

Tjänst:: Search Service

API-version:: 2026-04-01

Föreslår dokument i indexet som matchar den angivna partiella frågetexten.

POST {endpoint}/indexes('{indexName}')/docs/search.post.suggest?api-version=2026-04-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
endpoint	path	True	string (uri)	Slutpunkts-URL:en för söktjänsten.
indexName	path	True	string	Namnet på indexet.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandehuvud

Name	Obligatorisk	Typ	Description
Accept		Accept	Acceptera-rubriken.
x-ms-client-request-id		string (uuid)	En ogenomskinlig, globalt unik, klientgenererad strängidentifierare för begäran.

Begärandetext

Name	Obligatorisk	Typ	Description
search	True	string	Söktexten som ska användas för att föreslå dokument. Måste vara minst 1 tecken och högst 100 tecken.
suggesterName	True	string	Namnet på förslagstagaren enligt beskrivningen i den förslagssamling som ingår i indexdefinitionen.
filter		string	Ett OData-uttryck som filtrerar de dokument som övervägs för förslag.
fuzzy		boolean	Ett värde som anger om fuzzy-matchning ska användas för förslagsfrågan. Standardvärdet är false. När värdet är true hittar frågan förslag även om det finns ett ersatt eller saknat tecken i söktexten. Även om detta ger en bättre upplevelse i vissa scenarier, kommer det till en prestandakostnad eftersom sökningar med suddiga förslag är långsammare och förbrukar mer resurser.
highlightPostTag		string	En strängtagg som läggs till för att träffa markeringar. Måste anges med highlightPreTag. Om det utelämnas inaktiveras träffmarkering av förslag.
highlightPreTag		string	En strängtagg som förbereds för att träffa markeringar. Måste anges med highlightPostTag. Om det utelämnas inaktiveras träffmarkering av förslag.
minimumCoverage		number (double)	Ett tal mellan 0 och 100 som anger procentandelen av indexet som måste omfattas av en förslagsfråga för att frågan ska rapporteras som lyckad. Den här parametern kan vara användbar för att säkerställa söktillgänglighet även för tjänster med endast en replik. Standardvärdet är 80.
orderby		string	Den kommaavgränsade listan med OData-uttryck $orderby som resultaten ska sorteras efter. Varje uttryck kan vara antingen ett fältnamn eller ett anrop till funktionerna geo.distance() eller search.score(). Varje uttryck kan följas av asc för att indikera stigande eller desc för att indikera fallande. Standardvärdet är stigande ordning. Banden kommer att brytas av matchningspoängen för dokument. Om ingen $orderby har angetts sjunker standardsorteringsordningen efter dokumentmatchningspoäng. Det kan finnas högst 32 $orderby-satser.
searchFields		string	Den kommaavgränsade listan med fältnamn för att söka efter den angivna söktexten. Målfält måste ingå i den angivna förslagsställaren.
select		string	Den kommaavgränsade listan med fält som ska hämtas. Om det inte anges kommer endast nyckelfältet att inkluderas i resultatet.
top		integer (int32)	Antalet förslag som ska hämtas. Detta måste vara ett värde mellan 1 och 100. Standardvärdet är 5.

Svar

Name	Typ	Description
200 OK	SuggestDocumentsResult	Begäran har slutförts.
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Säkerhet

api-key

Typ: apiKey
I: header

OAuth2Auth

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Omfattningar

Name	Description
https://search.azure.com/.default

Exempel

SearchIndexSuggestDocumentsPost

Exempelbegäran

HTTP

POST https://exampleservice.search.windows.net/indexes('example-index')/docs/search.post.suggest?api-version=2026-04-01


{
  "filter": "ownerId eq 'sam' and id lt '15'",
  "fuzzy": true,
  "highlightPostTag": "</em>",
  "highlightPreTag": "<em>",
  "minimumCoverage": 80,
  "orderby": "id desc",
  "search": "p",
  "searchFields": "category",
  "select": "id,name,category,ownerId",
  "suggesterName": "sg",
  "top": 10
}

Exempelsvar

Statuskod:: 200

{
  "@search.coverage": 100,
  "value": [
    {
      "@search.text": "<em>pu</em>rple",
      "id": "14",
      "name": "test",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.text": "<em>pu</em>rple",
      "id": "13",
      "name": "test",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.text": "<em>pu</em>rple",
      "id": "11",
      "name": "test",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.text": "<em>pu</em>rple",
      "id": "1",
      "name": "test",
      "category": "purple",
      "ownerId": "sam"
    }
  ]
}

Definitioner

Name	Description
Accept	Acceptera-rubriken.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Vanligt felsvar för alla Azure Resource Manager-API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även formatet för OData-felsvar.).
SuggestDocumentsResult	Svar som innehåller förslag på frågeresultat från ett index.
SuggestRequest	Parametrar för filtrering, sortering, fuzzy-matchning och andra förslag på frågebeteenden.
SuggestResult	Ett resultat som innehåller ett dokument som hittas av en förslagsfråga, plus associerade metadata.

Accept

Uppräkning

Acceptera-rubriken.

Värde	Description
application/json;odata.metadata=none

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info		Den ytterligare informationen.
type	string	Typen av ytterligare information.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Felet ytterligare information.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Vanligt felsvar för alla Azure Resource Manager-API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även formatet för OData-felsvar.).

Name	Typ	Description
error	ErrorDetail	Felet objektet.

SuggestDocumentsResult

Objekt

Svar som innehåller förslag på frågeresultat från ett index.

Name	Typ	Description
@search.coverage	number (double)	Ett värde som anger procentandelen av indexet som ingick i frågan, eller null om minimumCoverage inte har angetts i begäran.
value	SuggestResult[]	Resultatsekvensen som returneras av frågan.

SuggestRequest

Objekt

Parametrar för filtrering, sortering, fuzzy-matchning och andra förslag på frågebeteenden.

Name	Typ	Description
filter	string	Ett OData-uttryck som filtrerar de dokument som övervägs för förslag.
fuzzy	boolean	Ett värde som anger om fuzzy-matchning ska användas för förslagsfrågan. Standardvärdet är false. När värdet är true hittar frågan förslag även om det finns ett ersatt eller saknat tecken i söktexten. Även om detta ger en bättre upplevelse i vissa scenarier, kommer det till en prestandakostnad eftersom sökningar med suddiga förslag är långsammare och förbrukar mer resurser.
highlightPostTag	string	En strängtagg som läggs till för att träffa markeringar. Måste anges med highlightPreTag. Om det utelämnas inaktiveras träffmarkering av förslag.
highlightPreTag	string	En strängtagg som förbereds för att träffa markeringar. Måste anges med highlightPostTag. Om det utelämnas inaktiveras träffmarkering av förslag.
minimumCoverage	number (double)	Ett tal mellan 0 och 100 som anger procentandelen av indexet som måste omfattas av en förslagsfråga för att frågan ska rapporteras som lyckad. Den här parametern kan vara användbar för att säkerställa söktillgänglighet även för tjänster med endast en replik. Standardvärdet är 80.
orderby	string	Den kommaavgränsade listan med OData-uttryck $orderby som resultaten ska sorteras efter. Varje uttryck kan vara antingen ett fältnamn eller ett anrop till funktionerna geo.distance() eller search.score(). Varje uttryck kan följas av asc för att indikera stigande eller desc för att indikera fallande. Standardvärdet är stigande ordning. Banden kommer att brytas av matchningspoängen för dokument. Om ingen $orderby har angetts sjunker standardsorteringsordningen efter dokumentmatchningspoäng. Det kan finnas högst 32 $orderby-satser.
search	string	Söktexten som ska användas för att föreslå dokument. Måste vara minst 1 tecken och högst 100 tecken.
searchFields	string	Den kommaavgränsade listan med fältnamn för att söka efter den angivna söktexten. Målfält måste ingå i den angivna förslagsställaren.
select	string	Den kommaavgränsade listan med fält som ska hämtas. Om det inte anges kommer endast nyckelfältet att inkluderas i resultatet.
suggesterName	string	Namnet på förslagstagaren enligt beskrivningen i den förslagssamling som ingår i indexdefinitionen.
top	integer (int32)	Antalet förslag som ska hämtas. Detta måste vara ett värde mellan 1 och 100. Standardvärdet är 5.

SuggestResult

Objekt

Ett resultat som innehåller ett dokument som hittas av en förslagsfråga, plus associerade metadata.

Name	Typ	Description
@search.text	string	Texten i förslagsresultatet.