Share via

Knowledge Sources - Get Status

Service:
Search Service
API Version:
2025-11-01-preview

Returns the current status and synchronization history of a knowledge source.

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

URI Parameters

Name In Required Type Description
endpoint
 path True

string

The endpoint URL of the search service.
sourceName
 path True

string

The name of the knowledge source for which to retrieve status.
api-version
 query True

string

Client Api Version.

Request Header

Name Required Type Description
x-ms-client-request-id

string (uuid)

The tracking ID sent with the request to help with debugging.

Responses

Name Type Description
200 OK

KnowledgeSourceStatus

Knowledge source status retrieved successfully.
Other Status Codes

ErrorResponse

Error response.

Examples

SearchServiceGetKnowledgeSourceStatus

Sample request

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

Sample response

Status code:
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
  }
}

Definitions

Name Description
CompletedSynchronizationState

Represents the completed state of the last synchronization.
ErrorAdditionalInfo

The resource management error additional info.
ErrorDetail

The error detail.
ErrorResponse

Error response
KnowledgeSourceStatistics

Statistical information about knowledge source synchronization history.
KnowledgeSourceStatus

Represents the status and synchronization history of a knowledge source.
KnowledgeSourceSynchronizationStatus

The current synchronization status of the knowledge source.
SynchronizationState

Represents the current state of an ongoing synchronization that spans multiple indexer runs.

CompletedSynchronizationState

Object

Represents the completed state of the last synchronization.

Name Type Description
endTime

string (date-time)

The end time of the last completed synchronization.
itemsSkipped

integer (int32)

The number of items skipped in the last synchronization.
itemsUpdatesFailed

integer (int32)

The number of item updates that failed in the last synchronization.
itemsUpdatesProcessed

integer (int32)

The number of item updates successfully processed in the last synchronization.
startTime

string (date-time)

The start time of the last completed synchronization.

ErrorAdditionalInfo

Object

The resource management error additional info.

Name Type Description
info

object

The additional info.
type

string

The additional info type.

ErrorDetail

Object

The error detail.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

The error additional info.
code

string

The error code.
details

ErrorDetail[]

The error details.
message

string

The error message.
target

string

The error target.

ErrorResponse

Object

Error response

Name Type Description
error

ErrorDetail

The error object.

KnowledgeSourceStatistics

Object

Statistical information about knowledge source synchronization history.

Name Type Description
averageItemsProcessedPerSynchronization

integer (int32)

The average number of items processed per synchronization.
averageSynchronizationDuration

string

The average duration of synchronizations in HH:MM:SS format.
totalSynchronization

integer (int32)

The total number of synchronizations completed.

KnowledgeSourceStatus

Object

Represents the status and synchronization history of a knowledge source.

Name Type Description
currentSynchronizationState

SynchronizationState

Current synchronization state that spans multiple indexer runs.
lastSynchronizationState

CompletedSynchronizationState

Details of the last completed synchronization. Null on first sync.
statistics

KnowledgeSourceStatistics

Statistical information about the knowledge source synchronization history. Null on first sync.
synchronizationInterval

string

The synchronization interval (e.g., '1d' for daily). Null if no schedule is configured.
synchronizationStatus

KnowledgeSourceSynchronizationStatus

The current synchronization status of the knowledge source.

KnowledgeSourceSynchronizationStatus

Enumeration

The current synchronization status of the knowledge source.

Value Description
creating

The knowledge source is being provisioned.
active

The knowledge source is active and synchronization runs are occurring.
deleting

The knowledge source is being deleted and synchronization is paused.

SynchronizationState

Object

Represents the current state of an ongoing synchronization that spans multiple indexer runs.

Name Type Description
itemsSkipped

integer (int32)

The number of items skipped in the current synchronization.
itemsUpdatesFailed

integer (int32)

The number of item updates that failed in the current synchronization.
itemsUpdatesProcessed

integer (int32)

The number of item updates successfully processed in the current synchronization.
startTime

string (date-time)

The start time of the current synchronization.