Indexers - Get Status
Gibt den aktuellen Status und Ausführungsverlauf eines Indexers zurück.
GET {endpoint}/indexers('{indexerName}')/search.status?api-version=2024-05-01-preview
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
endpoint
|
path | True |
string |
Die Endpunkt-URL des Suchdiensts. |
indexer
|
path | True |
string |
Der Name des Indexers, für den der Status abgerufen werden soll. |
api-version
|
query | True |
string |
Client-API-Version. |
Anforderungsheader
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
x-ms-client-request-id |
string uuid |
Die Verfolgungs-ID, die mit der Anforderung gesendet wurde, um beim Debuggen zu helfen. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK | ||
Other Status Codes |
Fehlerantwort. |
Beispiele
SearchServiceGetIndexerStatus
Beispielanforderung
GET https://myservice.search.windows.net/indexers('myindexer')/search.status?api-version=2024-05-01-preview
Beispiel für eine Antwort
{
"status": "running",
"lastResult": {
"status": "success",
"errorMessage": null,
"startTime": "2014-11-26T03:37:18.853Z",
"endTime": "2014-11-26T03:37:19.012Z",
"errors": [],
"warnings": [],
"itemsProcessed": 11,
"itemsFailed": 0,
"initialTrackingState": null,
"finalTrackingState": null
},
"executionHistory": [
{
"status": "success",
"errorMessage": null,
"startTime": "2014-11-26T03:37:18.853Z",
"endTime": "2014-11-26T03:37:19.012Z",
"errors": [],
"warnings": [],
"itemsProcessed": 11,
"itemsFailed": 0,
"initialTrackingState": null,
"finalTrackingState": null
},
{
"status": "transientFailure",
"errorMessage": null,
"startTime": "2014-11-26T03:28:10.125Z",
"endTime": "2014-11-26T03:28:12.007Z",
"errors": [
{
"key": "",
"errorMessage": "Document key cannot be missing or empty.",
"statusCode": 400,
"name": null,
"details": null,
"documentationLink": null
},
{
"key": "document id 1",
"errorMessage": "Could not read the value of column 'foo' at index '0'.",
"statusCode": 400,
"name": "DocumentExtraction.AzureBlob.MyDataSource",
"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.",
"name": null,
"details": null,
"documentationLink": null
},
{
"key": "document id 2",
"message": "Document was truncated to 50000 characters.",
"name": "Enrichment.LanguageDetectionSkill.#4",
"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"
}
],
"itemsProcessed": 1,
"itemsFailed": 2,
"initialTrackingState": null,
"finalTrackingState": null
}
],
"limits": {
"maxRunTime": "PT22H",
"maxDocumentExtractionSize": 256000000,
"maxDocumentContentCharactersToExtract": 4000000
}
}
Definitionen
Name | Beschreibung |
---|---|
Error |
Zusätzliche Informationen zum Ressourcenverwaltungsfehler. |
Error |
Die Fehlerdetails. |
Error |
Fehlerantwort |
Indexer |
Stellt den gesamten Zustand dar, der die aktuelle Ausführung des Indexers definiert und diktiert. |
Indexer |
Stellt das Ergebnis einer einzelnen Indexerausführung dar. |
Indexer |
Stellt den Status einer einzelnen Indexerausführung dar. |
Indexer |
Details zum status einer einzelnen Indexerausführung. |
Indexer |
Stellt den Gesamtstatus des Indexers dar. |
Indexing |
Stellt den Modus dar, in dem der Indexer ausgeführt wird. |
Search |
Stellt einen Indizierungsfehler auf Element- oder Dokumentebene dar. |
Search |
|
Search |
Stellt den aktuellen Status und Ausführungsverlauf eines Indexers dar. |
Search |
Stellt eine Warnung auf Elementebene dar. |
ErrorAdditionalInfo
Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Zusätzliche Informationen. |
type |
string |
Typ der zusätzlichen Informationen. |
ErrorDetail
Die Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Fehlerinformationen. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
IndexerCurrentState
Stellt den gesamten Zustand dar, der die aktuelle Ausführung des Indexers definiert und diktiert.
Name | Typ | Beschreibung |
---|---|---|
allDocsFinalChangeTrackingState |
string |
Ändern Sie den Wert des Nachverfolgungszustands, wenn die Indizierung für alle Dokumente in der Datenquelle abgeschlossen ist. |
allDocsInitialChangeTrackingState |
string |
Änderungsnachverfolgungsstatus, der verwendet wird, wenn die Indizierung für alle Dokumente in der Datenquelle beginnt. |
mode |
Der Modus, in dem der Indexer ausgeführt wird. |
|
resetDatasourceDocumentIds |
string[] |
Die Liste der zurückgesetzten Datenquellendokument-IDs. Die Dokument-ID der Datenquelle ist der eindeutige Bezeichner für die Daten in der Datenquelle. Der Indexer priorisiert die selektive erneute Erfassung dieser IDs. |
resetDocsFinalChangeTrackingState |
string |
Ändern Sie den Wert des Nachverfolgungszustands, wenn die Indizierung bei der Auswahl abgeschlossen ist, und setzen Sie Dokumente in der Datenquelle zurück. |
resetDocsInitialChangeTrackingState |
string |
Änderungsnachverfolgungsstatus, der verwendet wird, wenn die Indizierung beim Auswählen beginnt, dokumente in der Datenquelle zurücksetzen. |
resetDocumentKeys |
string[] |
Die Liste der Dokumentschlüssel, die zurückgesetzt wurden. Der Dokumentschlüssel ist der eindeutige Bezeichner des Dokuments für die Daten im Suchindex. Der Indexer priorisiert die selektive erneute Erfassung dieser Schlüssel. |
IndexerExecutionResult
Stellt das Ergebnis einer einzelnen Indexerausführung dar.
Name | Typ | Beschreibung |
---|---|---|
currentState |
Der gesamte Zustand, der die aktuelle Ausführung des Indexers definiert und diktiert. |
|
endTime |
string |
Die Endzeit dieser Indexerausführung, wenn die Ausführung bereits abgeschlossen wurde. |
errorMessage |
string |
Die Fehlermeldung, die den Fehler der obersten Ebene angibt, falls vorhanden. |
errors |
Die Indizierungsfehler auf Elementebene. |
|
finalTrackingState |
string |
Änderung des Nachverfolgungsstatus, mit dem die Ausführung eines Indexers abgeschlossen wurde. |
initialTrackingState |
string |
Änderung des Nachverfolgungsstatus, mit dem eine Indexerausführung gestartet wurde. |
itemsFailed |
integer |
Die Anzahl der Elemente, die während dieser Indexerausführung nicht indiziert werden konnten. |
itemsProcessed |
integer |
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 |
Die Startzeit dieser Indexerausführung. |
status |
Das Ergebnis dieser Indexerausführung. |
|
statusDetail |
Das Ergebnis dieser Indexerausführung. |
|
warnings |
Die Indizierungswarnungen auf Elementebene. |
IndexerExecutionStatus
Stellt den Status einer einzelnen Indexerausführung dar.
Name | Typ | Beschreibung |
---|---|---|
inProgress |
string |
Die Indexerausführung wird ausgeführt. |
reset |
string |
Der Indexer wurde zurückgesetzt. |
success |
string |
Die Indexerausführung wurde erfolgreich abgeschlossen. |
transientFailure |
string |
Bei einem Indexeraufruf ist ein Fehler aufgetreten, aber der Fehler ist möglicherweise vorübergehend. Indexeraufrufe werden gemäß Zeitplan fortgesetzt. |
IndexerExecutionStatusDetail
Details zum status einer einzelnen Indexerausführung.
Name | Typ | Beschreibung |
---|---|---|
resetDocs |
string |
Gibt an, dass das Zurücksetzen für einen Aufruf von ResetDocs erfolgt ist. |
IndexerStatus
Stellt den Gesamtstatus des Indexers dar.
Name | Typ | Beschreibung |
---|---|---|
error |
string |
Gibt an, dass beim Indexer ein Fehler aufgetreten ist, der ohne menschliches Eingreifen nicht korrigiert werden kann. |
running |
string |
Gibt an, dass der Indexer normal ausgeführt wird. |
unknown |
string |
Gibt an, dass sich der Indexer in einem unbekannten Zustand befindet. |
IndexingMode
Stellt den Modus dar, in dem der Indexer ausgeführt wird.
Name | Typ | Beschreibung |
---|---|---|
indexingAllDocs |
string |
Der Indexer indiziert alle Dokumente in der Datenquelle. |
indexingResetDocs |
string |
Der Indexer indiziert selektiv Dokumente in der Datenquelle zurück. Die dokumente, die indiziert werden, werden auf indexer status definiert. |
SearchIndexerError
Stellt einen Indizierungsfehler auf Element- oder Dokumentebene dar.
Name | Typ | Beschreibung |
---|---|---|
details |
string |
Weitere ausführliche Details zum Fehler, die beim Debuggen des Indexers unterstützt werden sollen. Dies ist möglicherweise nicht immer verfügbar. |
documentationLink |
string |
Ein Link zu einem Leitfaden zur Problembehandlung für diese Fehlerklassen. Dies ist möglicherweise nicht immer verfügbar. |
errorMessage |
string |
Die Meldung, die den Fehler beschreibt, der bei der Verarbeitung des Elements aufgetreten ist. |
key |
string |
Der Schlüssel des Elements, für das die Indizierung fehlgeschlagen ist. |
name |
string |
Der Name der Quelle, in der der Fehler aufgetreten ist. Dies kann sich beispielsweise auf eine bestimmte Qualifikation im angefügten Skillset beziehen. Dies ist möglicherweise nicht immer verfügbar. |
statusCode |
integer |
Der status Code, der angibt, warum der Indizierungsvorgang fehlgeschlagen ist. Mögliche Werte sind: 400 für ein falsch formatiertes Eingabedokument, 404 für nicht gefundenes Dokument, 409 für einen Versionskonflikt, 422, wenn der Index vorübergehend nicht verfügbar ist, oder 503 für wenn der Dienst zu ausgelastet ist. |
SearchIndexerLimits
Name | Typ | Beschreibung |
---|---|---|
maxDocumentContentCharactersToExtract |
number |
Die maximale Anzahl von Zeichen, die aus einem Dokument extrahiert werden, das für die Indizierung verwendet wird. |
maxDocumentExtractionSize |
number |
Die maximale Größe eines Dokuments in Bytes, die als gültig für die Indizierung betrachtet wird. |
maxRunTime |
string |
Die maximale Dauer, die der Indexer für eine Ausführung ausführen darf. |
SearchIndexerStatus
Stellt den aktuellen Status und Ausführungsverlauf eines Indexers dar.
Name | Typ | Beschreibung |
---|---|---|
executionHistory |
Verlauf der letzten Indexerausführungen, in umgekehrter chronologischer Reihenfolge sortiert. |
|
lastResult |
Das Ergebnis der letzten oder einer laufenden Indexerausführung. |
|
limits |
Die Ausführungsgrenzwerte für den Indexer. |
|
status |
Gesamtstatus des Indexers. |
SearchIndexerWarning
Stellt eine Warnung auf Elementebene dar.
Name | Typ | Beschreibung |
---|---|---|
details |
string |
Weitere ausführliche Details zur Warnung, die beim Debuggen des Indexers unterstützt werden sollen. Dies ist möglicherweise nicht immer verfügbar. |
documentationLink |
string |
Ein Link zu einem Leitfaden 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 während der Verarbeitung des Elements aufgetreten ist. |
name |
string |
Der Name der Quelle, von der die Warnung stammt. Dies kann sich beispielsweise auf eine bestimmte Qualifikation im angefügten Skillset beziehen. Dies ist möglicherweise nicht immer verfügbar. |