Indexers - Get Status

Služba:: Search Service

Verze rozhraní API:: 2025-09-01

Vrátí aktuální stav a historii provádění indexeru.

GET {endpoint}/indexers('{indexerName}')/search.status?api-version=2025-09-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string	Adresa URL koncového bodu vyhledávací služby.
indexerName	path	True	string	Název indexeru, pro který chcete načíst stav.
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é s požadavkem na pomoc s laděním.

Odpovědi

Name	Typ	Description
200 OK	SearchIndexerStatus
Other Status Codes	ErrorResponse	Chybová odpověď.

Příklady

SearchServiceGetIndexerStatus

Ukázkový požadavek

HTTP

GET https://stableexampleservice.search.windows.net/indexers('myindexer')/search.status?api-version=2025-09-01

Ukázková odpověď

Stavový kód:: 200

{
  "name": "myindexer",
  "status": "running",
  "lastResult": {
    "status": "success",
    "startTime": "2014-11-26T03:37:18.853Z",
    "endTime": "2014-11-26T03:37:19.012Z",
    "itemsProcessed": 11,
    "itemsFailed": 0,
    "errors": [],
    "warnings": []
  },
  "executionHistory": [
    {
      "status": "success",
      "startTime": "2014-11-26T03:37:18.853Z",
      "endTime": "2014-11-26T03:37:19.012Z",
      "itemsProcessed": 11,
      "itemsFailed": 0,
      "errors": [],
      "warnings": []
    },
    {
      "status": "transientFailure",
      "startTime": "2014-11-26T03:28:10.125Z",
      "endTime": "2014-11-26T03:28:12.007Z",
      "itemsProcessed": 1,
      "itemsFailed": 2,
      "errors": [
        {
          "key": "",
          "statusCode": 400,
          "errorMessage": "Document key cannot be missing or empty."
        },
        {
          "key": "document id 1",
          "statusCode": 400,
          "name": "DocumentExtraction.AzureBlob.MyDataSource",
          "errorMessage": "Could not read the value of column 'foo' at index '0'.",
          "details": "The file could not be parsed.",
          "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2049388"
        }
      ],
      "warnings": [
        {
          "key": "document id",
          "message": "A warning doesn't stop indexing, and is intended to inform you of certain interesting situations, like when a blob indexer truncates the amount of text extracted from a blob."
        },
        {
          "key": "document id 2",
          "name": "Enrichment.LanguageDetectionSkill.#4",
          "message": "Document was truncated to 50000 characters.",
          "details": "The skill did something that didn't break anything, nonetheless something we didn't expect happened, so it might be worth double checking.",
          "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2099692"
        }
      ]
    }
  ],
  "limits": {
    "maxRunTime": "PT22H",
    "maxDocumentExtractionSize": 256000000,
    "maxDocumentContentCharactersToExtract": 4000000
  }
}

Definice

Name	Description
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
IndexerExecutionResult	Představuje výsledek spuštění jednotlivých indexerů.
IndexerExecutionStatus	Představuje stav spuštění jednotlivých indexerů.
IndexerStatus	Představuje celkový stav indexeru.
SearchIndexerError	Představuje chybu indexování na úrovni položky nebo dokumentu.
SearchIndexerLimits
SearchIndexerStatus	Představuje aktuální stav a historii provádění indexeru.
SearchIndexerWarning	Představuje upozornění na úrovni položky.

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

IndexerExecutionResult

Objekt

Představuje výsledek spuštění jednotlivých indexerů.

Name	Typ	Description
endTime	string (date-time)	Čas ukončení provádění tohoto indexeru, pokud bylo provádění již dokončeno.
errorMessage	string	Chybová zpráva označující chybu nejvyšší úrovně, pokud existuje.
errors	SearchIndexerError[]	Chyby indexování na úrovni položky.
finalTrackingState	string	Změňte stav sledování, se kterým bylo dokončeno provádění indexeru.
initialTrackingState	string	Změňte stav sledování, se kterým bylo zahájeno provádění indexeru.
itemsFailed	integer (int32)	Počet položek, které se nepodařilo indexovat během provádění tohoto indexeru.
itemsProcessed	integer (int32)	Počet položek, které byly zpracovány během tohoto provádění indexeru. To zahrnuje jak úspěšně zpracované položky, tak položky, u kterých byl pokus o indexování neúspěšný.
startTime	string (date-time)	Čas zahájení tohoto provádění indexeru.
status	IndexerExecutionStatus	Výsledek tohoto spuštění indexeru.
warnings	SearchIndexerWarning[]	Upozornění indexování na úrovni položky.

IndexerExecutionStatus

Výčet

Představuje stav spuštění jednotlivých indexerů.

Hodnota	Description
transientFailure	Vyvolání indexeru se nezdařilo, ale selhání může být přechodné. Vyvolání indexeru budou pokračovat podle plánu.
success	Spuštění indexeru bylo úspěšně dokončeno.
inProgress	Probíhá provádění indexeru.
reset	Indexer byl resetován.

IndexerStatus

Výčet

Představuje celkový stav indexeru.

Hodnota	Description
unknown	Označuje, že indexer je v neznámém stavu.
error	Označuje, že v indexeru došlo k chybě, kterou nelze opravit bez lidského zásahu.
running	Označuje, že indexer běží normálně.

SearchIndexerError

Objekt

Představuje chybu indexování na úrovni položky nebo dokumentu.

Name	Typ	Description
details	string	Další podrobné podrobnosti o chybě, které vám pomůžou při ladění indexeru. To nemusí být vždy k dispozici.
documentationLink	string	Odkaz na průvodce odstraňováním potíží s těmito třídami chyb. To nemusí být vždy k dispozici.
errorMessage	string	Zpráva popisující chybu, ke které došlo při zpracování položky.
key	string	Klíč položky, u které se indexování nezdařilo.
name	string	Název zdroje, ze kterého chyba pochází. To může například odkazovat na konkrétní dovednost v připojené sadě dovedností. To nemusí být vždy k dispozici.
statusCode	integer (int32)	Stavový kód označující, proč se operace indexování nezdařila. Mezi možné hodnoty patří: 400 pro chybně formátovaný vstupní dokument, 404 pro nenalezený dokument, 409 pro konflikt verzí, 422, když je index dočasně nedostupný, nebo 503 pro případ, že je služba příliš zaneprázdněná.

SearchIndexerLimits

Objekt

Name	Typ	Description
maxDocumentContentCharactersToExtract	number (int64)	Maximální počet znaků, které budou extrahovány z dokumentu vybraného k indexování.
maxDocumentExtractionSize	number (int64)	Maximální velikost dokumentu v bajtech, která bude považována za platnou pro indexování.
maxRunTime	string (duration)	Maximální doba, po kterou může indexer běžet pro jedno spuštění.

SearchIndexerStatus

Objekt

Představuje aktuální stav a historii provádění indexeru.

Name	Typ	Description
executionHistory	IndexerExecutionResult[]	Historie nedávných spuštění indexeru, seřazená v obráceném chronologickém pořadí.
lastResult	IndexerExecutionResult	Výsledek nejnovějšího nebo probíhajícího provádění indexeru.
limits	SearchIndexerLimits	Limity provádění indexeru.
name	string	Název indexeru.
status	IndexerStatus	Celkový stav indexátoru.

SearchIndexerWarning

Objekt

Představuje upozornění na úrovni položky.

Name	Typ	Description
details	string	Další podrobné podrobnosti o upozornění, které vám pomůžou při ladění indexeru. To nemusí být vždy k dispozici.
documentationLink	string	Odkaz na průvodce odstraňováním potíží pro tyto třídy upozornění. To nemusí být vždy k dispozici.
key	string	Klíč položky, která vygenerovala varování.
message	string	Zpráva popisující upozornění, ke kterému došlo při zpracování položky.
name	string	Název zdroje, ze kterého upozornění pochází. To může například odkazovat na konkrétní dovednost v připojené sadě dovedností. To nemusí být vždy k dispozici.