Knowledge Sources - Get Status

Hizmet:

Search Service

API Sürümü:

2025-11-01-preview

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

GET https:///knowledgesources('{sourceName}')/status?api-version=2025-11-01-preview

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
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:///knowledgesources('ks-preview-test')/status?api-version=2025-11-01-preview

Örnek yanıt

Durum kodu:

200

{
  "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.).
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.
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.

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.
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.

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
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ı.