Documents - Index

Reference

Service:: Search Service

API Version:: 2023-10-01-Preview

Odešle dávku akcí zápisu do dokumentu do indexu.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string	Adresa URL koncového bodu vyhledávací služby.
indexName	path	True	string	Název indexu.
api-version	query	True	string	Verze rozhraní API klienta.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
x-ms-client-request-id		string uuid	ID sledování odeslané spolu s požadavkem na pomoc s laděním.

Text požadavku

Name	Vyžadováno	Typ	Description
value	True	IndexAction[]	Akce v dávce.

Odpovědi

Name	Typ	Description
200 OK	IndexDocumentsResult	Odpověď obsahující stav operací pro všechny akce v dávce.
Other Status Codes	IndexDocumentsResult	Odpověď obsahující stav operací pro všechny akce v dávce.
Other Status Codes	SearchError	Chybová odpověď.

Příklady

SearchIndexIndexDocuments

Sample Request

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"
    }
  ]
}

Sample Response

Status code:: 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
    }
  ]
}

Status code:: 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
    }
  ]
}

Definice

Name	Description
IndexAction	Představuje akci indexu, která pracuje s dokumentem.
IndexActionType	Operace, která se má provést s dokumentem v dávce indexování.
IndexBatch	Obsahuje dávku akcí zápisu do dokumentu, které se mají odeslat do indexu.
IndexDocumentsResult	Odpověď obsahující stav operací pro všechny dokumenty v požadavku indexování.
IndexingResult	Stav operace indexování pro jeden dokument
SearchError	Popisuje chybovou podmínku rozhraní API.

IndexAction

Představuje akci indexu, která pracuje s dokumentem.

Name	Typ	Description
@search.action	IndexActionType	Operace, která se má provést s dokumentem v dávce indexování.

IndexActionType

Operace, která se má provést s dokumentem v dávce indexování.

Name	Typ	Description
delete	string	Odebere z indexu zadaný dokument. Všechna pole, která zadáte v operaci odstranění kromě pole s klíčem, budou ignorována. Pokud chcete z dokumentu odebrat jednotlivá pole, použijte místo toho sloučení a nastavte pole explicitně na hodnotu null.
merge	string	Sloučí zadané hodnoty polí s existujícím dokumentem. Pokud dokument neexistuje, sloučení se nezdaří. Každé pole zadané ve sloučení nahradí stávající pole v dokumentu. To platí také pro kolekce primitivních a složitých typů.
mergeOrUpload	string	Chová se jako sloučení, pokud dokument s daným klíčem již existuje v indexu. Pokud dokument neexistuje, chová se jako nahrání s novým dokumentem.
upload	string	Vloží dokument do indexu, pokud je nový, a pokud existuje, aktualizuje ho. Všechna pole jsou v případě aktualizace nahrazena.

IndexBatch

Obsahuje dávku akcí zápisu do dokumentu, které se mají odeslat do indexu.

Name	Typ	Description
value	IndexAction[]	Akce v dávce.

IndexDocumentsResult

Odpověď obsahující stav operací pro všechny dokumenty v požadavku indexování.

Name	Typ	Description
value	IndexingResult[]	Seznam informací o stavu pro každý dokument v žádosti o indexování.

IndexingResult

Stav operace indexování pro jeden dokument

Name	Typ	Description
errorMessage	string	Chybová zpráva vysvětlující, proč operace indexování selhala pro dokument identifikovaný klíčem; null, pokud bylo indexování úspěšné.
key	string	Klíč dokumentu, který byl v požadavku na indexování.
status	boolean	Hodnota označující, jestli byla operace indexování pro dokument identifikovaný klíčem úspěšná.
statusCode	integer	Stavový kód operace indexování. Mezi možné hodnoty patří: 200 pro úspěšnou aktualizaci nebo odstranění, 201 pro úspěšné vytvoření dokumentu, 400 pro poškozený vstupní dokument, 404 pro dokument nebyl nalezen, 409 pro konflikt verze, 422, pokud je index dočasně nedostupný nebo 503 pro případě, že je služba příliš zaneprázdněná.

SearchError

Popisuje chybovou podmínku rozhraní API.

Name	Typ	Description
code	string	Jeden ze serverem definovaných chybových kódů.
details	SearchError[]	Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě.
message	string	Lidsky čitelná reprezentace chyby.

Share via