Indexers - Get Status

Tjänst:: Search Service

API-version:: 2026-04-01

Returnerar den aktuella status- och körningshistoriken för en indexerare.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
endpoint	path	True	string (uri)	Slutpunkts-URL:en för söktjänsten.
indexerName	path	True	string	Namnet på indexeraren.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandehuvud

Name	Obligatorisk	Typ	Description
x-ms-client-request-id		string (uuid)	En ogenomskinlig, globalt unik, klientgenererad strängidentifierare för begäran.
Accept		Accept	Acceptera-rubriken.

Svar

Name	Typ	Description
200 OK	SearchIndexerStatus	Begäran har slutförts.
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Säkerhet

api-key

Typ: apiKey
I: header

OAuth2Auth

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Omfattningar

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

Exempel

SearchServiceGetIndexerStatus

SearchServiceGetS3HDUnlimitedIndexerStatus

SearchServiceGetIndexerStatus

Exempelbegäran

HTTP

GET https://exampleservice.search.windows.net/indexers('myindexer')/search.status?api-version=2026-04-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
  }
}

SearchServiceGetS3HDUnlimitedIndexerStatus

Exempelbegäran

HTTP

GET https://exampleservice.search.windows.net/indexers('myindexer')/search.status?api-version=2026-04-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
Accept	Acceptera-rubriken.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Vanligt felsvar för alla Azure Resource Manager-API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även formatet för OData-felsvar.).
IndexerExecutionResult	Representerar resultatet av en enskild indexerarekörning.
IndexerExecutionStatus	Representerar statusen för en enskild indexerarkörning.
IndexerStatus	Representerar den övergripande indexerarstatusen.
SearchIndexerError	Representerar ett indexeringsfel på objekt- eller dokumentnivå.
SearchIndexerLimits	Representerar de gränser som kan tillämpas på en indexerare.
SearchIndexerStatus	Representerar den aktuella statusen och körningshistoriken för en indexerare.
SearchIndexerWarning	Representerar en varning på objektnivå.

Accept

Uppräkning

Acceptera-rubriken.

Värde	Description
application/json;odata.metadata=minimal

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info		Den ytterligare informationen.
type	string	Typen av ytterligare information.

ErrorDetail

Objekt

Felinformationen.

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

ErrorResponse

Objekt

Vanligt felsvar för alla Azure Resource Manager-API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även formatet för OData-felsvar.).

Name	Typ	Description
error	ErrorDetail	Felet objektet.

IndexerExecutionResult

Objekt

Representerar resultatet av en enskild indexerarekörning.

Name	Typ	Description
endTime	string (date-time)	Sluttiden för den här indexerarens körning, 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åndet som en indexerares körning har slutförts med.
initialTrackingState	string	Ändringsspårningstillstånd som en indexerares körning startades med.
itemsFailed	integer (int32)	Antalet objekt som inte kunde indexeras under den här indexeringskörningen.
itemsProcessed	integer (int32)	Antalet objekt som bearbetades under den här indexeringskörningen. Detta omfattar både objekt som bearbetats korrekt och objekt där indexering försöktes men misslyckades.
startTime	string (date-time)	Starttiden för den här indexerarens körning.
status	IndexerExecutionStatus	Resultatet av den här indexeringskörningen.
warnings	SearchIndexerWarning[]	Indexeringsvarningarna 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	Dessutom utförlig information om felet som hjälper dig 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 där felet uppstod. Detta kan till exempel referera till en viss färdighet i den bifogade 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 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

Representerar de gränser som kan tillämpas på en indexerare.

Name	Typ	Description
maxDocumentContentCharactersToExtract	integer (int64)	Det maximala antalet tecken som ska extraheras från ett dokument som hämtats för indexering.
maxDocumentExtractionSize	integer (int64)	Den maximala storleken på ett dokument, i byte, som anses vara giltig för indexering.
maxRunTime	string (duration)	Den maximala varaktighet som indexeraren tillåts 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 indexeringskörningarna, sorterade i omvänd kronologisk ordning.
lastResult	IndexerExecutionResult	Resultatet av den senaste eller pågående indexeringskö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	Dessutom utförlig information om varningen som hjälper dig att felsöka indexeraren. Detta kanske inte alltid är tillgängligt.
documentationLink	string	En länk till en felsökningsguide för dessa varningsklasser. Detta kanske inte alltid är tillgängligt.
key	string	Nyckeln för objektet som genererade en varning.
message	string	Meddelandet som beskriver varningen som inträffade när objektet bearbetades.
name	string	Namnet på källan som varningen kom från. Detta kan till exempel referera till en viss färdighet i den bifogade kompetensuppsättningen. Detta kanske inte alltid är tillgängligt.