Indexers - Get Status

Hizmet:: Search Service

API Sürümü:: 2025-09-01

Bir dizin oluşturucunun geçerli durumunu ve yürütme geçmişini döndürür.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string	Arama hizmetinin uç nokta URL'si.
indexerName	path	True	string	Durum almak için kullanılan dizin oluşturucunun adı.
api-version	query	True	string	İstemci Api Sürümü.

İstek Başlığı

Name	Gerekli	Tür	Description
x-ms-client-request-id		string (uuid)	Hata ayıklamaya yardımcı olmak için istekle birlikte gönderilen izleme kimliği.

Yanıtlar

Name	Tür	Description
200 OK	SearchIndexerStatus
Other Status Codes	ErrorResponse	Hata yanıtı.

Örnekler

SearchServiceGetIndexerStatus

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:: 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
  }
}

Tanımlar

Name	Description
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
IndexerExecutionResult	Tek bir dizin oluşturucu yürütmesinin sonucunu temsil eder.
IndexerExecutionStatus	Tek bir dizin oluşturucu yürütmesinin durumunu temsil eder.
IndexerStatus	Genel dizin oluşturucu durumunu temsil eder.
SearchIndexerError	Öğe veya belge düzeyinde dizin oluşturma hatasını temsil eder.
SearchIndexerLimits
SearchIndexerStatus	Bir dizin oluşturucunun geçerli durumunu ve yürütme geçmişini temsil eder.
SearchIndexerWarning	Öğe düzeyinde bir uyarıyı temsil eder.

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Nesne

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

IndexerExecutionResult

Nesne

Tek bir dizin oluşturucu yürütmesinin sonucunu temsil eder.

Name	Tür	Description
endTime	string (date-time)	Yürütme zaten tamamlanmışsa, bu dizin oluşturucu yürütmesinin bitiş zamanı.
errorMessage	string	Varsa, en üst düzey hatayı gösteren hata mesajı.
errors	SearchIndexerError[]	Öğe düzeyinde dizin oluşturma hataları.
finalTrackingState	string	Dizin oluşturucu yürütmesinin tamamlandığı izleme durumunu değiştirin.
initialTrackingState	string	Dizin oluşturucu yürütmesinin başlatıldığı izleme durumunu değiştirin.
itemsFailed	integer (int32)	Bu dizin oluşturucu yürütmesi sırasında dizine alınamayan öğelerin sayısı.
itemsProcessed	integer (int32)	Bu dizin oluşturucu yürütmesi sırasında işlenen öğelerin sayısı. Bu, hem başarıyla işlenen öğeleri hem de dizin oluşturmanın denendiği ancak başarısız olduğu öğeleri içerir.
startTime	string (date-time)	Bu dizin oluşturucu yürütmesinin başlangıç zamanı.
status	IndexerExecutionStatus	Bu dizin oluşturucu yürütmesinin sonucu.
warnings	SearchIndexerWarning[]	Öğe düzeyinde dizin oluşturma uyarıları.

IndexerExecutionStatus

Numaralandırma

Tek bir dizin oluşturucu yürütmesinin durumunu temsil eder.

Değer	Description
transientFailure	Dizin oluşturucu çağrısı başarısız oldu, ancak hata geçici olabilir. Dizin oluşturucu çağrıları zamanlamaya göre devam eder.
success	Dizin oluşturucu yürütme başarıyla tamamlandı.
inProgress	Dizin oluşturucu yürütme işlemi devam ediyor.
reset	Dizin oluşturucu sıfırlandı.

IndexerStatus

Numaralandırma

Genel dizin oluşturucu durumunu temsil eder.

Değer	Description
unknown	Dizin oluşturucunun bilinmeyen bir durumda olduğunu gösterir.
error	Dizin oluşturucunun insan müdahalesi olmadan düzeltilemeyen bir hatayla karşılaştığını gösterir.
running	Dizin oluşturucunun normal şekilde çalıştığını gösterir.

SearchIndexerError

Nesne

Öğe veya belge düzeyinde dizin oluşturma hatasını temsil eder.

Name	Tür	Description
details	string	Dizin oluşturucuda hata ayıklamaya yardımcı olmak için hatayla ilgili ek, ayrıntılı ayrıntılar. Bu her zaman mevcut olmayabilir.
documentationLink	string	Bu hata sınıfları için bir sorun giderme kılavuzu bağlantısı. Bu her zaman mevcut olmayabilir.
errorMessage	string	Öğe işlenirken oluşan hatayı açıklayan ileti.
key	string	Dizin oluşturmanın başarısız olduğu öğenin anahtarı.
name	string	Hatanın kaynaklandığı kaynağın adı. Örneğin, bu, ekli beceri kümesindeki belirli bir beceriye atıfta bulunabilir. Bu her zaman mevcut olmayabilir.
statusCode	integer (int32)	Dizin oluşturma işleminin neden başarısız olduğunu gösteren durum kodu. Olası değerler şunlardır: hatalı biçimlendirilmiş bir giriş belgesi için 400, belge bulunamadı için 404, sürüm çakışması için 409, dizin geçici olarak kullanılamadığında 422 veya hizmet çok meşgul olduğunda 503.

SearchIndexerLimits

Nesne

Name	Tür	Description
maxDocumentContentCharactersToExtract	number (int64)	Dizin oluşturma için alınan bir belgeden çıkarılacak en fazla karakter sayısı.
maxDocumentExtractionSize	number (int64)	Bir belgenin, indeksleme için geçerli kabul edilecek bayt cinsinden maksimum boyutu.
maxRunTime	string (duration)	Dizin oluşturucunun bir yürütme için çalışmasına izin verilen en uzun süre.

SearchIndexerStatus

Nesne

Bir dizin oluşturucunun geçerli durumunu ve yürütme geçmişini temsil eder.

Name	Tür	Description
executionHistory	IndexerExecutionResult[]	Ters kronolojik sıraya göre sıralanmış son dizin oluşturucu yürütmelerinin geçmişi.
lastResult	IndexerExecutionResult	En son veya devam eden dizin oluşturucu yürütmesinin sonucu.
limits	SearchIndexerLimits	Dizin oluşturucu için yürütme sınırları.
name	string	Dizin oluşturucunun adı.
status	IndexerStatus	Genel dizin oluşturucu durumu.

SearchIndexerWarning

Nesne

Öğe düzeyinde bir uyarıyı temsil eder.

Name	Tür	Description
details	string	Dizin oluşturucuda hata ayıklamaya yardımcı olmak için uyarıyla ilgili ek, ayrıntılı ayrıntılar. Bu her zaman mevcut olmayabilir.
documentationLink	string	Bu uyarı sınıfları için bir sorun giderme kılavuzu bağlantısı. Bu her zaman mevcut olmayabilir.
key	string	Bir uyarı oluşturan öğenin anahtarı.
message	string	Öğe işlenirken oluşan uyarıyı açıklayan ileti.
name	string	Uyarının kaynaklandığı kaynağın adı. Örneğin, bu, ekli beceri kümesindeki belirli bir beceriye atıfta bulunabilir. Bu her zaman mevcut olmayabilir.