Documents - Get

Tjänst:

Search Service

API-version:

2023-11-01

Hämtar ett dokument från indexet.

GET {endpoint}/indexes('{indexName}')/docs('{key}')?api-version=2023-11-01

Med valfria parametrar:

GET {endpoint}/indexes('{indexName}')/docs('{key}')?$select={$select}&api-version=2023-11-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
endpoint	path	True	string	Slutpunkts-URL:en för söktjänsten.
indexName	path	True	string	Namnet på indexet.
key	path	True	string	Nyckeln för dokumentet som ska hämtas.
api-version	query	True	string	Klient-API-version.
$select	query		string[]	Lista över fältnamn som ska hämtas för dokumentet. Alla fält som inte hämtas saknas i det returnerade dokumentet.

Begärandehuvud

Name	Obligatorisk	Typ	Description
x-ms-client-request-id		string uuid	Spårnings-ID:t som skickas med begäran för att hjälpa till med felsökning.

Svar

Name	Typ	Description
200 OK	LookupDocument	Svar som innehåller det begärda dokumentet.
Other Status Codes	SearchError	Felsvar.

Exempel

SearchIndexGetDocument

Exempelbegäran

HTTP

GET https://myservice.search.windows.net/indexes('myindex')/docs('1')?$select=docId,title,description&api-version=2023-11-01

Exempelsvar

Statuskod:

200

{
  "description": "Cheapest hotel in town",
  "docId": "1",
  "title": "Nice Hotel"
}

Definitioner

SearchError

Beskriver ett felvillkor för API:et.

Name	Typ	Description
code	string	En av en serverdefinierad uppsättning felkoder.
details	SearchError[]	En matris med information om specifika fel som ledde till det rapporterade felet.
message	string	En mänsklig läsbar representation av felet.