Indexers - Get Status

Dienst:

Search Service

API-Version:

2026-04-01

Gibt den aktuellen Status und den Ausführungsverlauf eines Indexers zurück.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string (uri)	Die Endpunkt-URL des Suchdiensts.
indexerName	path	True	string	Der Name des Indexers.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
Accept		Accept	Die Überschrift "Annehmen".
x-ms-client-request-id		string (uuid)	Ein undurchsichtiger, global eindeutiger, clientgenerierter Zeichenfolgenbezeichner für die Anforderung.

Antworten

Name	Typ	Beschreibung
200 OK	SearchIndexerStatus	Die Anforderung ist erfolgreich.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

api-key

Typ: apiKey
In: header

OAuth2Auth

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiche

Name	Beschreibung
https://search.azure.com/.default

Beispiele

SearchServiceGetIndexerStatus

SearchServiceGetS3HDUnlimitedIndexerStatus

SearchServiceGetIndexerStatus

Beispielanforderung

HTTP

GET https://exampleservice.search.windows.net/indexers('myindexer')/search.status?api-version=2026-04-01

Beispiel für eine Antwort

Statuscode:

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

SearchServiceGetS3HDUnlimitedIndexerStatus

Beispielanforderung

HTTP

GET https://exampleservice.search.windows.net/indexers('myindexer')/search.status?api-version=2026-04-01

Beispiel für eine Antwort

Statuscode:

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

Definitionen

Name	Beschreibung
Accept	Die Überschrift "Annehmen".
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Übliche Fehlerantwort für alle Azure Resource Manager APIs, um Fehlerdetails bei fehlgeschlagenen Operationen zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)
IndexerExecutionResult	Stellt das Ergebnis einer einzelnen Indexerausführung dar.
IndexerExecutionStatus	Stellt den Status einer einzelnen Indexerausführung dar.
IndexerStatus	Stellt den Gesamtstatus des Indexers dar.
SearchIndexerError	Stellt einen Indizierungsfehler auf Element- oder Dokumentebene dar.
SearchIndexerLimits	Repräsentiert die Grenzwerte, die auf einen Indexer angewendet werden können.
SearchIndexerStatus	Stellt den aktuellen Status und den Ausführungsverlauf eines Indexers dar.
SearchIndexerWarning	Stellt eine Warnung auf Elementebene dar.

Accept

Enumeration

Die Überschrift "Annehmen".

Wert	Beschreibung
application/json;odata.metadata=minimal

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info		Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Übliche Fehlerantwort für alle Azure Resource Manager APIs, um Fehlerdetails bei fehlgeschlagenen Operationen zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

IndexerExecutionResult

Objekt

Stellt das Ergebnis einer einzelnen Indexerausführung dar.

Name	Typ	Beschreibung
endTime	string (date-time)	Die Endzeit dieser Indizierungsausführung, wenn die Ausführung bereits abgeschlossen ist.
errorMessage	string	Die Fehlermeldung, die den Fehler auf oberster Ebene angibt, falls vorhanden.
errors	SearchIndexerError[]	Fehler bei der Indizierung auf Elementebene.
finalTrackingState	string	Änderungsnachverfolgungsstatus, mit dem die Indizierungsausführung abgeschlossen wurde.
initialTrackingState	string	Änderungsnachverfolgungsstatus, mit dem eine Indizierungsausführung gestartet wurde.
itemsFailed	integer (int32)	Die Anzahl der Elemente, die während dieser Indexerausführung nicht indiziert werden konnten.
itemsProcessed	integer (int32)	Die Anzahl der Elemente, die während dieser Indexerausführung verarbeitet wurden. Dies umfasst sowohl erfolgreich verarbeitete Elemente als auch Elemente, bei denen die Indizierung versucht wurde, aber fehlgeschlagen ist.
startTime	string (date-time)	Die Startzeit dieser Indizierungsausführung.
status	IndexerExecutionStatus	Das Ergebnis dieser Indizierungsausführung.
warnings	SearchIndexerWarning[]	Die Indizierungswarnungen auf Elementebene.

IndexerExecutionStatus

Enumeration

Stellt den Status einer einzelnen Indexerausführung dar.

Wert	Beschreibung
transientFailure	Ein Indexeraufruf ist fehlgeschlagen, aber der Fehler kann vorübergehend sein. Indexeraufrufe werden gemäß dem Zeitplan fortgesetzt.
success	Die Indexerausführung wurde erfolgreich abgeschlossen.
inProgress	Die Ausführung des Indexers wird ausgeführt.
reset	Der Indexer wurde zurückgesetzt.

IndexerStatus

Enumeration

Stellt den Gesamtstatus des Indexers dar.

Wert	Beschreibung
unknown	Gibt an, dass sich der Indexer in einem unbekannten Zustand befindet.
error	Gibt an, dass beim Indexer ein Fehler aufgetreten ist, der nicht ohne menschliches Eingreifen korrigiert werden kann.
running	Gibt an, dass der Indexer normal ausgeführt wird.

SearchIndexerError

Objekt

Stellt einen Indizierungsfehler auf Element- oder Dokumentebene dar.

Name	Typ	Beschreibung
details	string	Weitere ausführliche Details zum Fehler zur Unterstützung beim Debuggen des Indexers. Dies ist möglicherweise nicht immer verfügbar.
documentationLink	string	Ein Link zu einer Anleitung zur Problembehandlung für diese Fehlerklassen. Dies ist möglicherweise nicht immer verfügbar.
errorMessage	string	Die Meldung, die den Fehler beschreibt, der beim Verarbeiten des Elements aufgetreten ist.
key	string	Der Schlüssel des Elements, für das die Indizierung fehlgeschlagen ist.
name	string	Der Name der Quelle, an der der Fehler stammt. Dies kann sich beispielsweise auf eine bestimmte Fähigkeit im angefügten Skillset beziehen. Dies ist möglicherweise nicht immer verfügbar.
statusCode	integer (int32)	Der Statuscode, der angibt, warum der Indizierungsvorgang fehlgeschlagen ist. Mögliche Werte sind: 400 für ein falsch formatiertes Eingabedokument, 404 für das Dokument nicht gefunden, 409 für einen Versionskonflikt, 422, wenn der Index vorübergehend nicht verfügbar ist, oder 503, wenn der Dienst zu ausgelastet ist.

SearchIndexerLimits

Objekt

Repräsentiert die Grenzwerte, die auf einen Indexer angewendet werden können.

Name	Typ	Beschreibung
maxDocumentContentCharactersToExtract	integer (int64)	Die maximale Anzahl von Zeichen, die aus einem Dokument extrahiert werden, das für die Indizierung aufgenommen wird.
maxDocumentExtractionSize	integer (int64)	Die maximale Größe eines Dokuments in Byte, die für die Indizierung als gültig angesehen wird.
maxRunTime	string (duration)	Die maximale Dauer, die der Indexer für eine Ausführung ausführen darf.

SearchIndexerStatus

Objekt

Stellt den aktuellen Status und den Ausführungsverlauf eines Indexers dar.

Name	Typ	Beschreibung
executionHistory	IndexerExecutionResult[]	Verlauf der letzten Indizierungsausführungen, sortiert in umgekehrter chronologischer Reihenfolge.
lastResult	IndexerExecutionResult	Das Ergebnis der letzten oder einer in Bearbeitung ausgeführten Indizierungsausführung.
limits	SearchIndexerLimits	Die Ausführungsgrenzwerte für den Indexer.
name	string	Der Name des Indexers.
status	IndexerStatus	Gesamtindexerstatus.

SearchIndexerWarning

Objekt

Stellt eine Warnung auf Elementebene dar.

Name	Typ	Beschreibung
details	string	Weitere ausführliche Details zur Warnung zur Unterstützung beim Debuggen des Indexers. Dies ist möglicherweise nicht immer verfügbar.
documentationLink	string	Ein Link zu einem Handbuch zur Problembehandlung für diese Warnungsklassen. Dies ist möglicherweise nicht immer verfügbar.
key	string	Der Schlüssel des Elements, das eine Warnung generiert hat.
message	string	Die Meldung, die die Warnung beschreibt, die beim Verarbeiten des Elements aufgetreten ist.
name	string	Der Name der Quelle, an der die Warnung stammt. Dies kann sich beispielsweise auf eine bestimmte Fähigkeit im angefügten Skillset beziehen. Dies ist möglicherweise nicht immer verfügbar.