Indexers - Get Status

Usługa:: Search Service

Wersja interfejsu API:: 2025-08-01-preview

Zwraca bieżący stan i historię wykonywania indeksatora.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
endpoint	path	True	string	Adres URL punktu końcowego usługi wyszukiwania.
indexerName	path	True	string	Nazwa indeksatora, dla którego ma zostać pobrany stan.
api-version	query	True	string	Wersja interfejsu API klienta.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
x-ms-client-request-id		string (uuid)	Identyfikator śledzenia wysłany z żądaniem, aby pomóc w debugowaniu.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	SearchIndexerStatus
Other Status Codes	ErrorResponse	Odpowiedź na błąd.

Przykłady

SearchServiceGetIndexerStatus

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:: 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,
    "mode": "indexingAllDocs",
    "errors": [],
    "warnings": []
  },
  "executionHistory": [
    {
      "status": "success",
      "startTime": "2014-11-26T03:37:18.853Z",
      "endTime": "2014-11-26T03:37:19.012Z",
      "itemsProcessed": 11,
      "itemsFailed": 0,
      "mode": "indexingAllDocs",
      "errors": [],
      "warnings": []
    },
    {
      "status": "transientFailure",
      "startTime": "2014-11-26T03:28:10.125Z",
      "endTime": "2014-11-26T03:28:12.007Z",
      "itemsProcessed": 1,
      "itemsFailed": 2,
      "mode": "indexingAllDocs",
      "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
  },
  "currentState": {
    "mode": "indexingAllDocs",
    "resetDocumentKeys": [],
    "resetDatasourceDocumentIds": []
  }
}

Definicje

Nazwa	Opis
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
IndexerCurrentState	Reprezentuje cały stan, który definiuje i dyktuje bieżące wykonanie indeksatora.
IndexerExecutionResult	Reprezentuje wynik pojedynczego wykonania indeksatora.
IndexerExecutionStatus	Reprezentuje stan pojedynczego wykonania indeksatora.
IndexerExecutionStatusDetail	Szczegółowe informacje o stanie wykonania pojedynczego indeksatora.
IndexerStatus	Reprezentuje ogólny stan indeksatora.
IndexingMode	Reprezentuje tryb, w którym indeksator jest wykonywany.
SearchIndexerError	Reprezentuje błąd indeksowania na poziomie elementu lub dokumentu.
SearchIndexerLimits
SearchIndexerStatus	Reprezentuje bieżący stan i historię wykonywania indeksatora.
SearchIndexerWarning	Reprezentuje ostrzeżenie na poziomie elementu.

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

IndexerCurrentState

Objekt

Reprezentuje cały stan, który definiuje i dyktuje bieżące wykonanie indeksatora.

Nazwa	Typ	Opis
allDocsFinalTrackingState	string	Zmienianie wartości stanu śledzenia po zakończeniu indeksowania we wszystkich dokumentach w źródle danych.
allDocsInitialTrackingState	string	Zmienianie stanu śledzenia używanego po rozpoczęciu indeksowania we wszystkich dokumentach w źródle danych.
mode	IndexingMode	Tryb, w którym działa indeksator.
resetDatasourceDocumentIds	string[]	Lista identyfikatorów dokumentów źródła danych, które zostały zresetowane. Identyfikator dokumentu źródła danych jest unikatowym identyfikatorem danych w źródle danych. Indeksator będzie priorytetowo traktować selektywne ponowne pozyskiwanie tych identyfikatorów.
resetDocsFinalTrackingState	string	Zmień wartość stanu śledzenia po zakończeniu indeksowania po wybraniu i zresetowaniu dokumentów w źródle danych.
resetDocsInitialTrackingState	string	Zmienianie stanu śledzenia używanego, gdy indeksowanie rozpoczyna się po wybraniu i zresetowaniu dokumentów w źródle danych.
resetDocumentKeys	string[]	Lista kluczy dokumentów, które zostały zresetowane. Klucz dokumentu jest unikatowym identyfikatorem dokumentu dla danych w indeksie wyszukiwania. Indeksator będzie określać priorytety selektywnego ponownego pozyskiwania tych kluczy.
resyncFinalTrackingState	string	Zmień wartość stanu śledzenia po zakończeniu indeksowania w wybranych opcjach ze źródła danych.
resyncInitialTrackingState	string	Zmienianie stanu śledzenia używanego podczas uruchamiania indeksowania w opcjach selektywnych ze źródła danych.

IndexerExecutionResult

Objekt

Reprezentuje wynik pojedynczego wykonania indeksatora.

Nazwa	Typ	Opis
endTime	string (date-time)	Czas zakończenia wykonywania tego indeksatora, jeśli wykonanie zostało już ukończone.
errorMessage	string	Komunikat o błędzie wskazujący błąd najwyższego poziomu, jeśli występuje.
errors	SearchIndexerError[]	Błędy indeksowania na poziomie elementu.
finalTrackingState	string	Zmienianie stanu śledzenia, z którym zakończyło się wykonywanie indeksatora.
initialTrackingState	string	Zmienianie stanu śledzenia, z którym rozpoczęło się wykonywanie indeksatora.
itemsFailed	integer (int32)	Liczba elementów, których nie można zindeksować podczas wykonywania tego indeksatora.
itemsProcessed	integer (int32)	Liczba elementów, które zostały przetworzone podczas wykonywania tego indeksatora. Obejmuje to zarówno pomyślnie przetworzone elementy, jak i elementy, w przypadku których próbowano indeksować, ale nie powiodło się.
mode	IndexingMode	Tryb, w którym działa indeksator.
startTime	string (date-time)	Czas rozpoczęcia wykonywania tego indeksatora.
status	IndexerExecutionStatus	Wynik wykonania tego indeksatora.
statusDetail	IndexerExecutionStatusDetail	Wynik wykonania tego indeksatora.
warnings	SearchIndexerWarning[]	Ostrzeżenia dotyczące indeksowania na poziomie elementu.

IndexerExecutionStatus

Wyliczenie

Reprezentuje stan pojedynczego wykonania indeksatora.

Wartość	Opis
transientFailure	Wywołanie indeksatora nie powiodło się, ale błąd może być przejściowy. Wywołania indeksatora będą kontynuowane zgodnie z harmonogramem.
success	Wykonywanie indeksatora zostało zakończone pomyślnie.
inProgress	Wykonywanie indeksatora jest w toku.
reset	Indeksator został zresetowany.

IndexerExecutionStatusDetail

Wyliczenie

Szczegółowe informacje o stanie wykonania pojedynczego indeksatora.

Wartość	Opis
resetDocs	Wskazuje, że resetowanie, które miało miejsce, dotyczyło wywołania metody ResetDocs.
resync	Wskazuje selektywną ponowną synchronizację na podstawie opcji ze źródła danych.

IndexerStatus

Wyliczenie

Reprezentuje ogólny stan indeksatora.

Wartość	Opis
unknown	Wskazuje, że indeksator jest w nieznanym stanie.
error	Wskazuje, że indeksator napotkał błąd, którego nie można poprawić bez interwencji człowieka.
running	Wskazuje, że indeksator działa normalnie.

IndexingMode

Wyliczenie

Reprezentuje tryb, w którym indeksator jest wykonywany.

Wartość	Opis
indexingAllDocs	Indeksator indeksuje wszystkie dokumenty w źródle danych.
indexingResetDocs	Indeksator indeksuje selektywne, resetowane dokumenty w źródle danych. Indeksowane dokumenty są definiowane według statusu indeksatora.
indexingResync	Indeksator ponownie synchronizuje i indeksuje opcje selektywne ze źródła danych.

SearchIndexerError

Objekt

Reprezentuje błąd indeksowania na poziomie elementu lub dokumentu.

Nazwa	Typ	Opis
details	string	Dodatkowe, pełne szczegółowe informacje o błędzie, które pomagają w debugowaniu indeksatora. Nie zawsze jest to możliwe.
documentationLink	string	Link do przewodnika rozwiązywania problemów z tymi klasami błędów. Nie zawsze jest to możliwe.
errorMessage	string	Komunikat opisujący błąd, który wystąpił podczas przetwarzania elementu.
key	string	Klucz elementu, dla którego indeksowanie nie powiodło się.
name	string	Nazwa źródła, z którego pochodzi błąd. Na przykład może to odnosić się do konkretnej umiejętności w dołączonym zestawie umiejętności. Nie zawsze jest to możliwe.
statusCode	integer (int32)	Kod stanu wskazujący, dlaczego operacja indeksowania nie powiodła się. Możliwe wartości to: 400 dla źle sformułowanego dokumentu wejściowego, 404 dla dokumentu nie znaleziono, 409 dla konfliktu wersji, 422, gdy indeks jest tymczasowo niedostępny, lub 503 dla sytuacji, gdy usługa jest zbyt zajęta.

SearchIndexerLimits

Objekt

Nazwa	Typ	Opis
maxDocumentContentCharactersToExtract	number (int64)	Maksymalna liczba znaków, które zostaną wyodrębnione z dokumentu wybranego do indeksowania.
maxDocumentExtractionSize	number (int64)	Maksymalny rozmiar dokumentu (w bajtach), który zostanie uznany za prawidłowy do indeksowania.
maxRunTime	string (duration)	Maksymalny czas, przez jaki indeksator może być uruchamiany dla jednego wykonania.

SearchIndexerStatus

Objekt

Reprezentuje bieżący stan i historię wykonywania indeksatora.

Nazwa	Typ	Opis
currentState	IndexerCurrentState	Cały stan, który definiuje i dyktuje bieżące wykonanie indeksatora.
executionHistory	IndexerExecutionResult[]	Historia ostatnich wykonań indeksatora, posortowana w odwrotnej kolejności chronologicznej.
lastResult	IndexerExecutionResult	Wynik najnowszego lub trwającego wykonywania indeksatora.
limits	SearchIndexerLimits	Limity wykonywania dla indeksatora.
name	string	Nazwa indeksatora.
status	IndexerStatus	Ogólny stan indeksatora.

SearchIndexerWarning

Objekt

Reprezentuje ostrzeżenie na poziomie elementu.

Nazwa	Typ	Opis
details	string	Dodatkowe, pełne szczegółowe informacje o ostrzeżeniu, które pomagają w debugowaniu indeksatora. Nie zawsze jest to możliwe.
documentationLink	string	Link do przewodnika rozwiązywania problemów dla tych klas ostrzeżeń. Nie zawsze jest to możliwe.
key	string	Klucz elementu, który wygenerował ostrzeżenie.
message	string	Komunikat opisujący ostrzeżenie, które wystąpiło podczas przetwarzania elementu.
name	string	Nazwa źródła, z którego pochodzi ostrzeżenie. Na przykład może to odnosić się do konkretnej umiejętności w dołączonym zestawie umiejętności. Nie zawsze jest to możliwe.