Indexers - Get Status

Hizmet:: Search Service

API Sürümü:: 2026-04-01

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=2026-04-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string (uri)	Arama hizmetinin uç nokta URL'si.
indexerName	path	True	string	Dizin oluşturucunun adı.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Başlığı

Name	Gerekli	Tür	Description
Accept		Accept	Kabul Et başlığı.
x-ms-client-request-id		string (uuid)	İstek için opak, genel olarak benzersiz, istemci tarafından oluşturulan bir dize tanımlayıcısı.

Yanıtlar

Name	Tür	Description
200 OK	SearchIndexerStatus	İstek başarılı oldu.
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Güvenlik

api-key

Tür: apiKey
İçinde: header

OAuth2Auth

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Kapsamlar

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

Örnekler

SearchServiceGetIndexerStatus

SearchServiceGetS3HDUnlimitedIndexerStatus

SearchServiceGetIndexerStatus

Örnek isteği

HTTP

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

SearchServiceGetS3HDUnlimitedIndexerStatus

Örnek isteği

HTTP

GET https://exampleservice.search.windows.net/indexers('myindexer')/search.status?api-version=2026-04-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
Accept	Kabul Et başlığı.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Başarısız işlemlerin hata ayrıntılarını döndürmek için tüm Azure Resource Manager API'leri için genel hata yanıtı. (Bu, OData hata yanıt biçimini de izler.).
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üzeyi dizin oluşturma hatasını temsil eder.
SearchIndexerLimits	Bir indeksleyiciye uygulanabilecek sınırları temsil eder.
SearchIndexerStatus	Dizin oluşturucunun geçerli durumunu ve yürütme geçmişini temsil eder.
SearchIndexerWarning	Öğe düzeyi uyarıyı temsil eder.

Accept

Numaralandırma

Kabul Et başlığı.

Değer	Description
application/json;odata.metadata=minimal

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info		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

Başarısız işlemlerin hata ayrıntılarını döndürmek için tüm Azure Resource Manager API'leri için genel hata yanıtı. (Bu, OData hata yanıt biçimini de izler.).

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 tamamlandıysa, bu dizin oluşturucu yürütmesinin bitiş saati.
errorMessage	string	Varsa en üst düzey hatayı gösteren hata iletisi.
errors	SearchIndexerError[]	Öğe düzeyinde dizin oluşturma hataları.
finalTrackingState	string	Dizin oluşturucu yürütme işleminin tamamlandığı değişiklik izleme durumu.
initialTrackingState	string	Dizin oluşturucu yürütmenin başlatıldığı değişiklik izleme durumu.
itemsFailed	integer (int32)	Bu dizin oluşturucu yürütmesi sırasında dizinlenemeyen öğe sayısı.
itemsProcessed	integer (int32)	Bu dizin oluşturucu yürütmesi sırasında işlenen öğe 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ıç saati.
status	IndexerExecutionStatus	Bu dizin oluşturucu yürütmesinin sonucu.
warnings	SearchIndexerWarning[]	Öğe düzeyi 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üzeyi dizin oluşturma hatasını temsil eder.

Name	Tür	Description
details	string	Ek olarak, dizin oluşturucuda hata ayıklamaya yardımcı olmak için hatayla ilgili ayrıntılı ayrıntılar. Bu her zaman kullanılamayabilir.
documentationLink	string	Bu hata sınıfları için sorun giderme kılavuzunun bağlantısı. Bu her zaman kullanılamayabilir.
errorMessage	string	Öğe işlenirken oluşan hatayı açıklayan ileti.
key	string	Dizin oluşturma işleminin 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 işaret edebilir. Bu her zaman kullanılamayabilir.
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ş 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

Bir indeksleyiciye uygulanabilecek sınırları temsil eder.

Name	Tür	Description
maxDocumentContentCharactersToExtract	integer (int64)	Dizin oluşturma için alınan bir belgeden ayıklanacak karakter sayısı üst sınırı.
maxDocumentExtractionSize	integer (int64)	Bir belgenin bayt cinsinden en büyük boyutu, dizin oluşturma için geçerli kabul edilir.
maxRunTime	string (duration)	Dizin oluşturucunun bir yürütme için çalışmasına izin verilen en uzun süre.

SearchIndexerStatus

Nesne

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

Name	Tür	Description
executionHistory	IndexerExecutionResult[]	Ters kronolojik düzende 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üzeyi uyarıyı temsil eder.

Name	Tür	Description
details	string	Dizin oluşturucuda hata ayıklamaya yardımcı olmak için uyarıyla ilgili ayrıntılı ek ayrıntılar. Bu her zaman kullanılamayabilir.
documentationLink	string	Bu uyarı sınıfları için sorun giderme kılavuzu bağlantısı. Bu her zaman kullanılamayabilir.
key	string	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 işaret edebilir. Bu her zaman kullanılamayabilir.