Documents - Index

Service:: Search Service

API-versie:: 2023-10-01-Preview

Hiermee wordt een batch documentschrijfacties naar de index verzonden.

POST {endpoint}/indexes('{indexName}')/docs/search.index?api-version=2023-10-01-Preview

URI-parameters

Name	In	Vereist	Type	Description
endpoint	path	True	string	De eindpunt-URL van de zoekservice.
indexName	path	True	string	De naam van de index.
api-version	query	True	string	Client-API-versie.

Aanvraagkoptekst

Name	Vereist	Type	Description
x-ms-client-request-id		string (uuid)	De tracerings-id die is verzonden met de aanvraag om hulp te bieden bij foutopsporing.

Aanvraagbody

Name	Vereist	Type	Description
value	True	IndexAction[]	De acties in de batch.

Antwoorden

Name	Type	Description
200 OK	IndexDocumentsResult	Antwoord met de status van bewerkingen voor alle acties in de batch.
Other Status Codes	IndexDocumentsResult	Antwoord met de status van bewerkingen voor alle acties in de batch.
Other Status Codes	SearchError	Foutreactie.

Voorbeelden

SearchIndexIndexDocuments

Voorbeeldaanvraag

HTTP

POST https://myservice.search.windows.net/indexes('myindex')/docs/search.index?api-version=2023-10-01-Preview

{
  "value": [
    {
      "@search.action": "upload",
      "docId": "1",
      "title": "Fancy Stay",
      "description": "Best hotel in town"
    },
    {
      "@search.action": "merge",
      "docId": "2",
      "title": "Roach Motel"
    },
    {
      "@search.action": "mergeOrUpload",
      "docId": "3",
      "title": "Econo Motel"
    },
    {
      "@search.action": "delete",
      "docId": "4"
    }
  ]
}

Voorbeeldrespons

Statuscode:: 200

{
  "value": [
    {
      "key": "1",
      "status": true,
      "errorMessage": null,
      "statusCode": 201
    },
    {
      "key": "2",
      "status": true,
      "errorMessage": null,
      "statusCode": 200
    },
    {
      "key": "3",
      "status": true,
      "errorMessage": null,
      "statusCode": 200
    },
    {
      "key": "4",
      "status": true,
      "errorMessage": null,
      "statusCode": 200
    }
  ]
}

Statuscode:: 207

{
  "value": [
    {
      "key": "1",
      "status": true,
      "errorMessage": null,
      "statusCode": 200
    },
    {
      "key": "2",
      "status": false,
      "errorMessage": "Document not found.",
      "statusCode": 404
    },
    {
      "key": "3",
      "status": true,
      "errorMessage": null,
      "statusCode": 200
    },
    {
      "key": "4",
      "status": true,
      "errorMessage": null,
      "statusCode": 200
    }
  ]
}

Definities

Name	Description
IndexAction	Vertegenwoordigt een indexactie die op een document werkt.
IndexActionType	De bewerking die moet worden uitgevoerd op een document in een indexeringsbatch.
IndexBatch	Bevat een batch documentschrijfacties die naar de index moeten worden verzonden.
IndexDocumentsResult	Antwoord met de status van bewerkingen voor alle documenten in de indexeringsaanvraag.
IndexingResult	Status van een indexeringsbewerking voor één document.
SearchError	Beschrijft een foutvoorwaarde voor de API.

IndexAction

Object

Vertegenwoordigt een indexactie die op een document werkt.

Name	Type	Description
@search.action	IndexActionType	De bewerking die moet worden uitgevoerd op een document in een indexeringsbatch.

IndexActionType

Opsomming

De bewerking die moet worden uitgevoerd op een document in een indexeringsbatch.

Waarde	Description
upload	Het document wordt in de index ingevoegd als het nieuw is en het document bijwerkt als het bestaat. Alle velden worden vervangen in de updatecase.
merge	Hiermee worden de opgegeven veldwaarden samengevoegd met een bestaand document. Als het document niet bestaat, mislukt de samenvoegbewerking. Elk veld dat u in een samenvoeging opgeeft, vervangt het bestaande veld in het document. Dit geldt ook voor verzamelingen primitieve en complexe typen.
mergeOrUpload	Gedraagt zich als samenvoegen als een document met de opgegeven sleutel al in de index bestaat. Als het document niet bestaat, gedraagt het zich als uploaden met een nieuw document.
delete	Hiermee verwijdert u het opgegeven document uit de index. Elk veld dat u opgeeft in een andere verwijderbewerking dan het sleutelveld, wordt genegeerd. Als u een afzonderlijk veld uit een document wilt verwijderen, gebruikt u in plaats daarvan samenvoegen en stelt u het veld expliciet in op null.

IndexBatch

Object

Bevat een batch documentschrijfacties die naar de index moeten worden verzonden.

Name	Type	Description
value	IndexAction[]	De acties in de batch.

IndexDocumentsResult

Object

Antwoord met de status van bewerkingen voor alle documenten in de indexeringsaanvraag.

Name	Type	Description
value	IndexingResult[]	De lijst met statusinformatie voor elk document in de indexeringsaanvraag.

IndexingResult

Object

Status van een indexeringsbewerking voor één document.

Name	Type	Description
errorMessage	string	Het foutbericht waarin wordt uitgelegd waarom de indexeringsbewerking is mislukt voor het document dat is geïdentificeerd door de sleutel; null als indexering is geslaagd.
key	string	De sleutel van een document dat zich in de indexeringsaanvraag bevond.
status	boolean	Een waarde die aangeeft of de indexeringsbewerking is geslaagd voor het document dat door de sleutel is geïdentificeerd.
statusCode	integer (int32)	De statuscode van de indexeringsbewerking. Mogelijke waarden zijn: 200 voor een geslaagde update of verwijdering, 201 voor het maken van documenten, 400 voor een ongeldig invoerdocument, 404 voor document niet gevonden, 409 voor een versieconflict, 422 wanneer de index tijdelijk niet beschikbaar is of 503 voor wanneer de service te druk is.

SearchError

Object

Beschrijft een foutvoorwaarde voor de API.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
details	SearchError[]	Een matrix met details over specifieke fouten die hebben geleid tot deze gemelde fout.
message	string	Een leesbare weergave van de fout.