Knowledge Sources - Get Status

Hizmet:: Search Service

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

Bilgi kaynağının durumunu alır.

GET {endpoint}/knowledgesources('{sourceName}')/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.
sourceName	path	True	string	Bilgi kaynağının 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	KnowledgeSourceStatus	İ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

SearchServiceGetKnowledgeSourceStatus

Örnek isteği

HTTP

GET https://exampleservice.search.windows.net/knowledgesources('ks-example-index')/status?api-version=2026-04-01

Örnek yanıt

Durum kodu:: 200

{
  "kind": "searchIndex",
  "synchronizationStatus": "active",
  "synchronizationInterval": "1d",
  "currentSynchronizationState": {
    "startTime": "2024-11-26T03:37:18.853Z",
    "itemsUpdatesProcessed": 10,
    "itemsUpdatesFailed": 2,
    "itemsSkipped": 1
  },
  "lastSynchronizationState": {
    "startTime": "2024-11-25T03:37:18.853Z",
    "endTime": "2024-11-25T03:38:19.012Z",
    "itemsUpdatesProcessed": 8,
    "itemsUpdatesFailed": 1,
    "itemsSkipped": 0
  },
  "statistics": {
    "totalSynchronization": 5,
    "averageSynchronizationDuration": "PT30M",
    "averageItemsProcessedPerSynchronization": 100
  }
}

Tanımlar

Name	Description
Accept	Kabul Et başlığı.
CompletedSynchronizationState	Son senkronizasyonun tamamlanmış durumunu temsil eder.
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.).
KnowledgeSourceKind	Bilgi kaynağının türü.
KnowledgeSourceStatistics	Bilgi kaynağı eşitleme geçmişi hakkında istatistiksel bilgiler.
KnowledgeSourceStatus	Bir bilgi kaynağının durumunu ve senkronizasyon geçmişini temsil eder.
KnowledgeSourceSynchronizationError	Bilgi kaynağı senkronizasyon çalışması sırasında karşılaşılan belge düzeyinde indeksleme hatasını temsil eder.
KnowledgeSourceSynchronizationStatus	Bilgi kaynağının mevcut senkronizasyon durumu.
SynchronizationState	Birden fazla indeksleyici çalıştırmasını kapsayan devam eden bir senkronizasyonun mevcut durumunu temsil eder.

Accept

Numaralandırma

Kabul Et başlığı.

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

CompletedSynchronizationState

Nesne

Son senkronizasyonun tamamlanmış durumunu temsil eder.

Name	Tür	Description
endTime	string (date-time)	Son tamamlanan eşitlemenin bitiş saati.
itemsSkipped	integer (int32)	Son eşitlemede atlanan öğelerin sayısı.
itemsUpdatesFailed	integer (int32)	Son eşitlemede başarısız olan öğe güncelleştirmelerinin sayısı.
itemsUpdatesProcessed	integer (int32)	Son eşitlemede başarıyla işlenen öğe güncelleştirmelerinin sayısı.
startTime	string (date-time)	Son tamamlanmış senkronizasyonun başlama saati.

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.

KnowledgeSourceKind

Numaralandırma

Bilgi kaynağının türü.

Değer	Description
searchIndex	Bir Arama Dizini'nden veri okuyan bir bilgi kaynağı.
azureBlob	Azure Blob Depolama'dan bir Arama Dizini'ne veri okuyan ve alan bir bilgi kaynağı.
indexedOneLake	Indekslenmiş OneLake'den veri okuyan bir bilgi kaynağı.
web	Web'den veri okuyan bir bilgi kaynağı.

KnowledgeSourceStatistics

Nesne

Bilgi kaynağı eşitleme geçmişi hakkında istatistiksel bilgiler.

Name	Tür	Description
averageItemsProcessedPerSynchronization	integer (int32)	Senkronizasyon başına işlenen ortalama ürünler.
averageSynchronizationDuration	string	HH:MM:SS formatında ortalama senkronizasyon süresi.
totalSynchronization	integer (int32)	Toplam senkronizasyon sayısı.

KnowledgeSourceStatus

Nesne

Bir bilgi kaynağının durumunu ve senkronizasyon geçmişini temsil eder.

Name	Tür	Description
currentSynchronizationState	SynchronizationState	Birden fazla indeksleyici çalıştırmasını kapsayan mevcut senkronizasyon durumu.
kind	KnowledgeSourceKind	Bilgi Kaynağı türünü doğrudan Durum yanıtından tanımlar.
lastSynchronizationState	CompletedSynchronizationState	Son tamamlanan senkronizasyonun detayları. İlk senkronizasyonda null.
statistics	KnowledgeSourceStatistics	Bilgi kaynağı senkronizasyon geçmişi hakkında istatistiksel bilgiler. İlk senkronizasyonda null.
synchronizationInterval	string	Senkronizasyon aralığı (örneğin, günlük için '1d'). Herhangi bir program konfigürasyonu yoksa sıfır.
synchronizationStatus	KnowledgeSourceSynchronizationStatus	Mevcut senkronizasyon durumu.

KnowledgeSourceSynchronizationError

Nesne

Bilgi kaynağı senkronizasyon çalışması sırasında karşılaşılan belge düzeyinde indeksleme hatasını temsil eder.

Name	Tür	Description
details	string	Başarısızlıkla ilgili ek bağlamsal bilgiler.
docId	string	Senkronizasyon çalışmasında başarısız olan belge veya öğe için benzersiz tanımlayıcı.
documentationLink	string	İlgili sorun giderme dokümantasyonuna bir bağlantı.
errorMessage	string	İnsan tarafından okunabilir, müşteri tarafından görünür hata mesajı.
name	string	Hatayı bildiren alım veya işleme bileşeninin adı.
statusCode	integer (int32)	Arıza kategorisini temsil eden HTTP benzeri durum kodu (örneğin, 400).

KnowledgeSourceSynchronizationStatus

Numaralandırma

Bilgi kaynağının mevcut senkronizasyon durumu.

Değer	Description
creating	Bilgi kaynağı sağlanıyor.
active	Bilgi kaynağı aktiftir ve senkronizasyon çalışmaları gerçekleşmektedir.
deleting	Bilgi kaynağı siliniyor ve senkronizasyon duraklıyor.

SynchronizationState

Nesne

Birden fazla indeksleyici çalıştırmasını kapsayan devam eden bir senkronizasyonun mevcut durumunu temsil eder.

Name	Tür	Description
errors	KnowledgeSourceSynchronizationError[]	Mevcut senkronizasyon çalışması sırasında karşılaşılan belge düzeyinde indeksleme hatalarının toplanması. Sadece hata olduğunda geri gönderilir.
itemsSkipped	integer (int32)	Mevcut senkronizasyonda atlanan öğe sayısı.
itemsUpdatesFailed	integer (int32)	Geçerli eşitlemede başarısız olan öğe güncelleştirmelerinin sayısı.
itemsUpdatesProcessed	integer (int32)	Mevcut senkronizasyonda başarıyla işlenen öğe güncelleme sayısı.
startTime	string (date-time)	Mevcut senkronizasyonun başlangıç zamanı.