Knowledge Sources - Get Status

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

GET {endpoint}/knowledgesources('{sourceName}')/status?api-version=2026-11-01-preview

URI Parametreleri

Veri Akışı Adı İç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ığı

Veri Akışı Adı Gerekli Tür Description
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ı.

Accept

Accept

Accept başlığı.

Yanıtlar

Veri Akışı Adı 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

Veri Akışı Adı Description
https://search.azure.com/.default

Örnekler

SearchServiceGetKnowledgeSourceGraphStatistics
SearchServiceGetKnowledgeSourceStatus
SearchServiceGetKnowledgeSourceStatusFile

SearchServiceGetKnowledgeSourceGraphStatistics

Örnek isteği

GET https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-graph-cache')/status?api-version=2026-11-01-preview


Örnek yanıt

{
  "kind": "azureBlob",
  "synchronizationStatus": "active",
  "synchronizationInterval": "1d",
  "currentSynchronizationState": {
    "startTime": "2026-11-01T00:00:00Z",
    "itemsUpdatesProcessed": 2,
    "itemsUpdatesFailed": 0,
    "itemsSkipped": 0,
    "errors": [],
    "graphStatistics": {
      "ontologyName": "product-ontology",
      "triplesWritten": 0
    }
  },
  "lastSynchronizationState": {
    "startTime": "2026-10-31T00:00:00Z",
    "endTime": "2026-10-31T00:01:00Z",
    "itemsUpdatesProcessed": 3,
    "itemsUpdatesFailed": 0,
    "itemsSkipped": 0,
    "graphStatistics": {
      "ontologyName": "previous-product-ontology",
      "triplesWritten": 2147483648
    }
  }
}

SearchServiceGetKnowledgeSourceStatus

Örnek isteği

GET https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')/status?api-version=2026-11-01-preview


Örnek yanıt

{
  "kind": "azureBlob",
  "synchronizationStatus": "active",
  "synchronizationInterval": "1d",
  "currentSynchronizationState": {
    "startTime": "2024-11-26T03:37:18.853Z",
    "itemsUpdatesProcessed": 10,
    "itemsUpdatesFailed": 2,
    "itemsSkipped": 1,
    "errors": []
  },
  "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
  }
}

SearchServiceGetKnowledgeSourceStatusFile

Örnek isteği

GET https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')/status?api-version=2026-11-01-preview


Örnek yanıt

{
  "kind": "file",
  "synchronizationStatus": "active",
  "synchronizationInterval": "1d",
  "fileCapacity": {
    "maxFileCount": 1000,
    "remainingFileCount": 997,
    "maxFileSizeBytes": 134217728
  }
}

Tanımlar

Veri Akışı Adı Description
Accept

Accept başlığı.

CompletedSynchronizationState

Son senkronizasyonun tamamlanmış durumunu temsil eder.

ErrorAdditionalInfo

Kaynak yönetimi hatasına ilişkin ek bilgiler.

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

KnowledgeSourceFileCapacity

Dosya bilgi kaynağı için dosya yükleme kapasitesi.

KnowledgeSourceGraphStatistics

Bilgi kaynağı senkronizasyonu için grafik çıkarma istatistikleri.

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

Accept başlığı.

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

CompletedSynchronizationState

Son senkronizasyonun tamamlanmış durumunu temsil eder.

Veri Akışı Adı Tür Description
endTime

string (date-time)

Son tamamlanan eşitlemenin bitiş saati.

graphStatistics

KnowledgeSourceGraphStatistics

Bu senkronizasyon için grafik çıkarma istatistikleri. Grafik çıkarımı yapılmadığında çıkarıldı.

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

Kaynak yönetimi hatasına ilişkin ek bilgiler.

Veri Akışı Adı Tür Description
info

Ek bilgiler.

type

string

Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Veri Akışı Adı Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgisi.

code

string

Hata kodu.

details

ErrorDetail[]

Hata ayrıntıları.

message

string

Hata iletisi.

target

string

Hata hedefi

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

Veri Akışı Adı Tür Description
error

ErrorDetail

Hata nesnesi.

KnowledgeSourceFileCapacity

Dosya bilgi kaynağı için dosya yükleme kapasitesi.

Veri Akışı Adı Tür Description
maxFileCount

integer (int32)

Bilgi kaynağında izin verilen maksimum dosya sayısı.

maxFileSizeBytes

integer (int64)

Yüklenen tek bir dosyanın maksimum bayt cinsinden boyutu.

remainingFileCount

integer (int32)

İstek anında yüklenebilecek ek dosya sayısı.

KnowledgeSourceGraphStatistics

Bilgi kaynağı senkronizasyonu için grafik çıkarma istatistikleri.

Veri Akışı Adı Tür Description
ontologyName

string

Ontoloji adı, varsa.

triplesWritten

integer (int64)

minimum: 0

Bu senkronizasyon sırasında başarıyla yazılmış grafik kayıtlarının sayısı, aynı mantıksal çıktının tekrar tekrar teslimi hariç. Bu, toplam grafik indeks boyutu değildir.

KnowledgeSourceKind

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

indexedSharePoint

Indekslenmiş SharePoint'ten veri okuyan bir bilgi kaynağı.

indexedOneLake

Indekslenmiş OneLake'den veri okuyan bir bilgi kaynağı.

indexedSql

Azure SQL Veritabanı veya SQL Yönetilen Örneği'dan bir Arama İndeksine veri alan ve alan bir bilgi kaynağı.

web

Web'den veri okuyan bir bilgi kaynağı.

remoteSharePoint

Uzak SharePoint'ten veri okuyan bir bilgi kaynağı.

workIQ

İş IQ'sundan veri okuyan bir bilgi kaynağı

file

Doğrudan dosya yükleme ve indekslemeyi destekleyen bir bilgi kaynağı.

mcpServer

MCP (Model Context Protocol) sunucusu tarafından desteklenen bir bilgi kaynağı.

fabricDataAgent

Fabric Veri Ajanı'ndan veri alan bir bilgi kaynağı.

fabricOntology

Microsoft Fabric Ontology ontolojilerinden veri alan bir bilgi kaynağı.

KnowledgeSourceStatistics

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

Veri Akışı Adı 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

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

Veri Akışı Adı Tür Description
currentSynchronizationState

SynchronizationState

Birden fazla indeksleyici çalıştırmasını kapsayan mevcut senkronizasyon durumu.

fileCapacity

KnowledgeSourceFileCapacity

Dosya bilgi kaynağı için dosya yükleme kapasitesi. Diğer bilgi kaynakları için çıkarıldı.

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

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

Veri Akışı Adı 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

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

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

Veri Akışı Adı 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.

graphStatistics

KnowledgeSourceGraphStatistics

Bu senkronizasyon için grafik çıkarma istatistikleri. Grafik çıkarımı yapılmadığında çıkarıldı.

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