Knowledge Sources - Get Status

Szolgáltatás:: Search Service

API-verzió:: 2025-11-01-preview

Visszanyeri a tudásforrás státuszát.

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

URI-paraméterek

Név	In	Kötelező	Típus	Description
endpoint	path	True	string (uri)	A keresési szolgáltatás végpontjának URL-címe.
sourceName	path	True	string	A tudásforrás neve.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem fejléce

Név	Kötelező	Típus	Description
x-ms-client-request-id		string (uuid)	A kérés átlátszatlan, globálisan egyedi, ügyfél által generált sztringazonosítója.
Accept		Accept	Az Elfogadás fejléce.

Válaszok

Név	Típus	Description
200 OK	KnowledgeSourceStatus	A kérés sikeres volt.
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Biztonság

api-key

Típus: apiKey
In: header

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Hatókörök

Név	Description
https://search.azure.com/.default

Példák

SearchServiceGetKnowledgeSourceStatus

Mintakérelem

HTTP

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

Mintaválasz

Állapotkód:: 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
  }
}

Definíciók

Név	Description
Accept	Az Elfogadás fejléce.
CompletedSynchronizationState	Az utolsó szinkronizálás befejezett állapotát jelöli.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Az Összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)
KnowledgeSourceStatistics	Statisztikai adatok a tudásforrás-szinkronizálási előzményekről.
KnowledgeSourceStatus	Egy tudásforrás állapotát és szinkronizálási előzményeit jelöli.
KnowledgeSourceSynchronizationStatus	A tudásforrás aktuális szinkronizálási állapota.
SynchronizationState	Egy folyamatban lévő szinkronizálás aktuális állapotát jelöli, amely több indexelő futtatására terjed ki.

Accept

Felsorolás

Az Elfogadás fejléce.

Érték	Description
application/json;odata.metadata=minimal

CompletedSynchronizationState

Tárgy

Az utolsó szinkronizálás befejezett állapotát jelöli.

Név	Típus	Description
endTime	string (date-time)	Az utolsó befejezett szinkronizálás befejezési ideje.
itemsSkipped	integer (int32)	Az utolsó szinkronizálás során kihagyott elemek száma.
itemsUpdatesFailed	integer (int32)	Az utolsó szinkronizálás során meghiúsult elemfrissítések száma.
itemsUpdatesProcessed	integer (int32)	Az utolsó szinkronizálás során sikeresen feldolgozott elemfrissítések száma.
startTime	string (date-time)	Az utolsó befejezett szinkronizálás kezdési időpontja.

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Név	Típus	Description
info		A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Név	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Tárgy

Az Összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)

Név	Típus	Description
error	ErrorDetail	A hibaobjektum.

KnowledgeSourceStatistics

Tárgy

Statisztikai adatok a tudásforrás-szinkronizálási előzményekről.

Név	Típus	Description
averageItemsProcessedPerSynchronization	integer (int32)	Az átlagos feldolgozás a szinkronizálás során.
averageSynchronizationDuration	string	Átlagos szinkronizációs időtartam HH:MM:SS formátumban.
totalSynchronization	integer (int32)	A szinkronizációk összesített száma.

KnowledgeSourceStatus

Tárgy

Egy tudásforrás állapotát és szinkronizálási előzményeit jelöli.

Név	Típus	Description
currentSynchronizationState	SynchronizationState	Több indexelőfuttatásra kiterjedő aktuális szinkronizálási állapot.
lastSynchronizationState	CompletedSynchronizationState	Az utolsó befejezett szinkronizálás részletei. Null az első szinkronizáláskor.
statistics	KnowledgeSourceStatistics	Statisztikai adatok a tudásforrás szinkronizálási előzményeiről. Null az első szinkronizáláskor.
synchronizationInterval	string	A szinkronizálási intervallum (pl. "1d" a napi). Null, ha nincs konfigurálva ütemezés.
synchronizationStatus	KnowledgeSourceSynchronizationStatus	A jelenlegi szinkronizációs állapot.

KnowledgeSourceSynchronizationStatus

Felsorolás

A tudásforrás aktuális szinkronizálási állapota.

Érték	Description
creating	A tudásforrás kiépítése folyamatban van.
active	A tudásforrás aktív, és szinkronizálási futtatások zajlanak.
deleting	A tudásforrás törlődik, és a szinkronizálás szünetel.

SynchronizationState

Tárgy

Egy folyamatban lévő szinkronizálás aktuális állapotát jelöli, amely több indexelő futtatására terjed ki.

Név	Típus	Description
itemsSkipped	integer (int32)	Az aktuális szinkronizálás során kihagyott elemek száma.
itemsUpdatesFailed	integer (int32)	Az aktuális szinkronizálás során meghiúsult elemfrissítések száma.
itemsUpdatesProcessed	integer (int32)	Az aktuális szinkronizálás során sikeresen feldolgozott elemfrissítések száma.
startTime	string (date-time)	Az aktuális szinkronizálás kezdési időpontja.