Indexers - Get Status

Tjänst:: Search Service

API-version:: 2025-09-01

Returnerar aktuell status och körningshistorik för en indexerare.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
endpoint	path	True	string	Slutpunkts-URL:en för söktjänsten.
indexerName	path	True	string	Namnet på indexeraren som status ska hämtas för.
api-version	query	True	string	Klient-API-version.

Begärandehuvud

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

Svar

Name	Typ	Description
200 OK	SearchIndexerStatus
Other Status Codes	ErrorResponse	Felsvar.

Exempel

SearchServiceGetIndexerStatus

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:: 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
  }
}

Definitioner

Name	Description
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
IndexerExecutionResult	Representerar resultatet av en enskild indexerarkörning.
IndexerExecutionStatus	Representerar statusen för en enskild indexerarkörning.
IndexerStatus	Representerar den övergripande indexerarstatusen.
SearchIndexerError	Representerar ett indexeringsfel på objekt- eller dokumentnivå.
SearchIndexerLimits
SearchIndexerStatus	Representerar den aktuella statusen och körningshistoriken för en indexerare.
SearchIndexerWarning	Representerar en varning på objektnivå.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

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

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

IndexerExecutionResult

Objekt

Representerar resultatet av en enskild indexerarkörning.

Name	Typ	Description
endTime	string (date-time)	Sluttiden för den här indexerarkörningen, om körningen redan har slutförts.
errorMessage	string	Felmeddelandet som anger felet på den översta nivån, om det finns något.
errors	SearchIndexerError[]	Indexeringsfel på objektnivå.
finalTrackingState	string	Ändra spårningstillstånd som en indexerarkörning slutfördes med.
initialTrackingState	string	Ändra spårningstillstånd som en indexerarkörning startade med.
itemsFailed	integer (int32)	Antalet objekt som inte kunde indexeras under den här indexerarkörningen.
itemsProcessed	integer (int32)	Antalet objekt som bearbetades under den här indexerarkörningen. Detta inkluderar både bearbetade objekt och objekt där indexering har gjorts men misslyckats.
startTime	string (date-time)	Starttiden för den här indexerarkörningen.
status	IndexerExecutionStatus	Resultatet av den här indexerarkörningen.
warnings	SearchIndexerWarning[]	Indexeringsvarningar på objektnivå.

IndexerExecutionStatus

Uppräkning

Representerar statusen för en enskild indexerarkörning.

Värde	Description
transientFailure	Ett indexeraranrop har misslyckats, men felet kan vara tillfälligt. Indexeraranrop fortsätter enligt schema.
success	Indexerarens körning har slutförts.
inProgress	Indexerarens körning pågår.
reset	Indexeraren har återställts.

IndexerStatus

Uppräkning

Representerar den övergripande indexerarstatusen.

Värde	Description
unknown	Anger att indexeraren är i ett okänt tillstånd.
error	Anger att indexeraren har drabbats av ett fel som inte kan korrigeras utan mänsklig inblandning.
running	Anger att indexeraren körs normalt.

SearchIndexerError

Objekt

Representerar ett indexeringsfel på objekt- eller dokumentnivå.

Name	Typ	Description
details	string	Ytterligare, utförlig information om felet för att hjälpa till att felsöka indexeraren. Detta kanske inte alltid är tillgängligt.
documentationLink	string	En länk till en felsökningsguide för dessa felklasser. Detta kanske inte alltid är tillgängligt.
errorMessage	string	Meddelandet som beskriver felet som uppstod när objektet bearbetades.
key	string	Nyckeln för det objekt som indexeringen misslyckades för.
name	string	Namnet på källan som felet kom från. Detta kan till exempel referera till en viss färdighet i den kopplade kompetensuppsättningen. Detta kanske inte alltid är tillgängligt.
statusCode	integer (int32)	Statuskoden som anger varför indexeringsåtgärden misslyckades. Möjliga värden är: 400 för ett felaktigt utformat indatadokument, 404 för dokumentet hittades inte, 409 för en versionskonflikt, 422 när indexet är tillfälligt otillgängligt eller 503 för när tjänsten är för upptagen.

SearchIndexerLimits

Objekt

Name	Typ	Description
maxDocumentContentCharactersToExtract	number (int64)	Det maximala antalet tecken som ska extraheras från ett dokument som hämtas för indexering.
maxDocumentExtractionSize	number (int64)	Den maximala storleken på ett dokument, i byte, som anses vara giltigt för indexering.
maxRunTime	string (duration)	Den maximala varaktighet som indexeraren får köra för en körning.

SearchIndexerStatus

Objekt

Representerar den aktuella statusen och körningshistoriken för en indexerare.

Name	Typ	Description
executionHistory	IndexerExecutionResult[]	Historik över de senaste indexerarkörningarna, sorterade i omvänd kronologisk ordning.
lastResult	IndexerExecutionResult	Resultatet av den senaste eller pågående indexerarkörningen.
limits	SearchIndexerLimits	Körningsgränserna för indexeraren.
name	string	Namnet på indexeraren.
status	IndexerStatus	Övergripande indexerarstatus.

SearchIndexerWarning

Objekt

Representerar en varning på objektnivå.

Name	Typ	Description
details	string	Ytterligare, utförlig information om varningen för att hjälpa till att felsöka indexeraren. Detta kanske inte alltid är tillgängligt.
documentationLink	string	En länk till en felsökningsguide för dessa klasser av varningar. Detta kanske inte alltid är tillgängligt.
key	string	Nyckeln för det objekt som genererade en varning.
message	string	Meddelandet som beskriver varningen som uppstod när objektet bearbetades.
name	string	Namnet på den källa som varningen kommer från. Detta kan till exempel referera till en viss färdighet i den kopplade kompetensuppsättningen. Detta kanske inte alltid är tillgängligt.

Dela via

Indexers - Get Status

URI-parametrar

Begärandehuvud

Svar

Exempel

SearchServiceGetIndexerStatus

Exempelbegäran

Exempelsvar

Definitioner

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IndexerExecutionResult

IndexerExecutionStatus

IndexerStatus

SearchIndexerError

SearchIndexerLimits

SearchIndexerStatus

SearchIndexerWarning