Indexers - Get Status

Usługa:

Search Service

Wersja interfejsu API:

2026-04-01

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

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
endpoint	path	True	string (uri)	Adres URL punktu końcowego usługi wyszukiwania.
indexerName	path	True	string	Nazwa indeksatora.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
Accept		Accept	Nagłówek Accept.
x-ms-client-request-id		string (uuid)	Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	SearchIndexerStatus	Żądanie zakończyło się pomyślnie.
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

api-key

Typ: apiKey
W: header

OAuth2Auth

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Zakresy

Nazwa	Opis
https://search.azure.com/.default

Przykłady

SearchServiceGetIndexerStatus

SearchServiceGetS3HDUnlimitedIndexerStatus

SearchServiceGetIndexerStatus

Przykładowe żądanie

HTTP

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

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,
    "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

Przykładowe żądanie

HTTP

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

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

Definicje

Nazwa	Opis
Accept	Nagłówek Accept.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Typowa odpowiedź na błędy dla wszystkich interfejsów API usługi Azure Resource Manager w celu zwrócenia szczegółów błędu dla operacji, które zakończyły się niepowodzeniem. (Jest to również zgodne z formatem odpowiedzi na błąd OData).
IndexerExecutionResult	Reprezentuje wynik pojedynczego wykonywania indeksatora.
IndexerExecutionStatus	Reprezentuje stan pojedynczego wykonania indeksatora.
IndexerStatus	Reprezentuje ogólny stan indeksatora.
SearchIndexerError	Reprezentuje błąd indeksowania na poziomie elementu lub dokumentu.
SearchIndexerLimits	Reprezentuje granice, które można zastosować do indeksatora.
SearchIndexerStatus	Reprezentuje bieżący stan i historię wykonywania indeksatora.
SearchIndexerWarning	Reprezentuje ostrzeżenie na poziomie elementu.

Accept

Wyliczenie

Nagłówek Accept.

Wartość	Opis
application/json;odata.metadata=minimal

ErrorAdditionalInfo

Objekt

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

Nazwa	Typ	Opis
info		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	Cel błędu.

ErrorResponse

Objekt

Typowa odpowiedź na błędy dla wszystkich interfejsów API usługi Azure Resource Manager w celu zwrócenia szczegółów błędu dla operacji, które zakończyły się niepowodzeniem. (Jest to również zgodne z formatem odpowiedzi na błąd OData).

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

IndexerExecutionResult

Objekt

Reprezentuje wynik pojedynczego wykonywania indeksatora.

Nazwa	Typ	Opis
endTime	string (date-time)	Godzina zakończenia wykonywania indeksatora, jeśli wykonanie zostało już ukończone.
errorMessage	string	Komunikat o błędzie wskazujący błąd najwyższego poziomu, jeśli istnieje.
errors	SearchIndexerError[]	Błędy indeksowania na poziomie elementu.
finalTrackingState	string	Stan śledzenia zmian, za pomocą którego zakończono wykonywanie indeksatora.
initialTrackingState	string	Stan śledzenia zmian, za pomocą którego rozpoczęto wykonywanie indeksatora.
itemsFailed	integer (int32)	Liczba elementów, których nie można indeksować podczas wykonywania indeksatora.
itemsProcessed	integer (int32)	Liczba elementów przetworzonych podczas wykonywania indeksatora. Obejmuje to zarówno pomyślnie przetworzone elementy, jak i elementy, w których podjęto próbę indeksowania, ale nie powiodło się.
startTime	string (date-time)	Godzina rozpoczęcia wykonywania indeksatora.
status	IndexerExecutionStatus	Wynik wykonania 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.

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.

SearchIndexerError

Objekt

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

Nazwa	Typ	Opis
details	string	Dodatkowe szczegółowe informacje o błędzie ułatwiające debugowanie indeksatora. Może to nie być zawsze dostępne.
documentationLink	string	Link do przewodnika rozwiązywania problemów dla tych klas błędów. Może to nie być zawsze dostępne.
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. Może to nie być zawsze dostępne.
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 w przypadku konfliktu wersji, 422, gdy indeks jest tymczasowo niedostępny lub 503 w przypadku, gdy usługa jest zbyt zajęta.

SearchIndexerLimits

Objekt

Reprezentuje granice, które można zastosować do indeksatora.

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

SearchIndexerStatus

Objekt

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

Nazwa	Typ	Opis
executionHistory	IndexerExecutionResult[]	Historia ostatnich wykonań indeksatora posortowanych w odwrotnej kolejności chronologicznej.
lastResult	IndexerExecutionResult	Wynik ostatniego lub w toku wykonywania indeksatora.
limits	SearchIndexerLimits	Limity wykonywania 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 szczegółowe informacje o ostrzeżeniu ułatwiające debugowanie indeksatora. Może to nie być zawsze dostępne.
documentationLink	string	Link do przewodnika rozwiązywania problemów dla tych klas ostrzeżeń. Może to nie być zawsze dostępne.
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. Może to nie być zawsze dostępne.