Knowledge Sources - Get Status

Služba:: Search Service

Verze rozhraní API:: 2025-11-01-preview

Získává status zdroje znalostí.

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

Parametry identifikátoru URI

Název	V	Vyžadováno	Typ	Description
endpoint	path	True	string (uri)	Adresa URL koncového bodu vyhledávací služby.
sourceName	path	True	string	Název zdroje znalostí.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Hlavička požadavku

Název	Vyžadováno	Typ	Description
x-ms-client-request-id		string (uuid)	Neprůzrný globálně jedinečný identifikátor řetězce vygenerovaný klientem pro požadavek.
Accept		Accept	Hlavička Accept.

Odpovědi

Název	Typ	Description
200 OK	KnowledgeSourceStatus	Požadavek byl úspěšný.
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

api-key

Typ: apiKey
V: header

OAuth2Auth

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Rozsahy

Název	Description
https://search.azure.com/.default

Příklady

SearchServiceGetKnowledgeSourceStatus

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kó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
  }
}

Definice

Název	Description
Accept	Hlavička Accept.
CompletedSynchronizationState	Představuje dokončený stav poslední synchronizace.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Běžná chybová odpověď pro všechna rozhraní API Azure Resource Manageru pro vrácení podrobností o chybě pro neúspěšné operace (To se také řídí formátem odpovědi na chybu OData.)
KnowledgeSourceStatistics	Statistické informace o historii synchronizace zdrojů znalostí.
KnowledgeSourceStatus	Představuje stav a historii synchronizace zdroje znalostí.
KnowledgeSourceSynchronizationStatus	Aktuální stav synchronizace zdroje znalostí.
SynchronizationState	Představuje aktuální stav probíhající synchronizace, která zahrnuje více spuštění indexeru.

Accept

Výčet

Hlavička Accept.

Hodnota	Description
application/json;odata.metadata=minimal

CompletedSynchronizationState

Objekt

Představuje dokončený stav poslední synchronizace.

Název	Typ	Description
endTime	string (date-time)	Čas ukončení poslední dokončené synchronizace.
itemsSkipped	integer (int32)	Počet položek přeskočených při poslední synchronizaci.
itemsUpdatesFailed	integer (int32)	Počet aktualizací položek, které se nezdařily při poslední synchronizaci.
itemsUpdatesProcessed	integer (int32)	Počet aktualizací položek úspěšně zpracovaných při poslední synchronizaci.
startTime	string (date-time)	Čas zahájení poslední dokončené synchronizace.

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Název	Typ	Description
info		Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Název	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Běžná chybová odpověď pro všechna rozhraní API Azure Resource Manageru pro vrácení podrobností o chybě pro neúspěšné operace (To se také řídí formátem odpovědi na chybu OData.)

Název	Typ	Description
error	ErrorDetail	Objekt chyby.

KnowledgeSourceStatistics

Objekt

Statistické informace o historii synchronizace zdrojů znalostí.

Název	Typ	Description
averageItemsProcessedPerSynchronization	integer (int32)	Průměrné položky zpracované na jednu synchronizaci.
averageSynchronizationDuration	string	Průměrná doba synchronizace ve formátu HH:MM:SS.
totalSynchronization	integer (int32)	Celkový počet synchronizací.

KnowledgeSourceStatus

Objekt

Představuje stav a historii synchronizace zdroje znalostí.

Název	Typ	Description
currentSynchronizationState	SynchronizationState	Aktuální stav synchronizace, který zahrnuje více spuštění indexeru.
lastSynchronizationState	CompletedSynchronizationState	Podrobnosti o poslední dokončené synchronizaci. Hodnota null při první synchronizaci.
statistics	KnowledgeSourceStatistics	Statistické informace o historii synchronizace zdrojů znalostí. Hodnota null při první synchronizaci.
synchronizationInterval	string	Interval synchronizace (např. "1d" pro denní). Hodnota null, pokud není nakonfigurován žádný plán.
synchronizationStatus	KnowledgeSourceSynchronizationStatus	Aktuální stav synchronizace.

KnowledgeSourceSynchronizationStatus

Výčet

Aktuální stav synchronizace zdroje znalostí.

Hodnota	Description
creating	Zdroj znalostí se poskytuje.
active	Zdroj znalostí je aktivní a dochází k synchronizačním běhům.
deleting	Zdroj znalostí se maže a synchronizace se pozastaví.

SynchronizationState

Objekt

Představuje aktuální stav probíhající synchronizace, která zahrnuje více spuštění indexeru.

Název	Typ	Description
itemsSkipped	integer (int32)	Počet položek přeskočených v aktuální synchronizaci.
itemsUpdatesFailed	integer (int32)	Počet aktualizací položek, které se v aktuální synchronizaci nezdařily.
itemsUpdatesProcessed	integer (int32)	Počet aktualizací položek úspěšně zpracovaných v aktuální synchronizaci.
startTime	string (date-time)	Čas zahájení aktuální synchronizace.