Knowledge Sources - Get Status
지식 소스의 상태를 검색합니다.
GET https:///knowledgesources('{sourceName}')/status?api-version=2025-11-01-previewURI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
source
|
path | True |
string |
참조 자료의 이름입니다. |
|
api-version
|
query | True |
string minLength: 1 |
이 작업에 사용할 API 버전입니다. |
요청 헤더
| Name | 필수 | 형식 | Description |
|---|---|---|---|
| Accept | True |
Accept 헤더입니다. |
|
| x-ms-client-request-id |
string (uuid) |
요청에 대한 불투명하고 전역적으로 고유한 클라이언트 생성 문자열 식별자입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
요청이 성공했습니다. |
|
| Other Status Codes |
예기치 않은 오류 응답입니다. |
보안
api-key
형식:
apiKey
In(다음 안에):
header
OAuth2Auth
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/v2.0/authorize
범위
| Name | Description |
|---|---|
| https://search.azure.com/.default |
예제
SearchServiceGetKnowledgeSourceStatus
샘플 요청
GET https:///knowledgesources('ks-preview-test')/status?api-version=2025-11-01-preview
샘플 응답
{
"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
}
}정의
| Name | Description |
|---|---|
| Accept |
Accept 헤더입니다. |
|
Completed |
마지막 동기화의 완료된 상태를 나타냅니다. |
|
Error |
리소스 관리 오류 추가 정보입니다. |
|
Error |
오류 세부 정보입니다. |
|
Error |
실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다. |
|
Knowledge |
지식 원본 동기화 기록에 대한 통계 정보입니다. |
|
Knowledge |
참조 자료의 상태 및 동기화 기록을 나타냅니다. |
|
Knowledge |
참조 자료의 현재 동기화 상태입니다. |
|
Synchronization |
여러 인덱서 실행에 걸쳐 진행 중인 동기화의 현재 상태를 나타냅니다. |
Accept
Accept 헤더입니다.
| 값 | Description |
|---|---|
| application/json;odata.metadata=minimal |
CompletedSynchronizationState
마지막 동기화의 완료된 상태를 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| endTime |
string (date-time) |
마지막으로 완료된 동기화의 종료 시간입니다. |
| itemsSkipped |
integer (int32) |
마지막 동기화에서 건너뛴 항목 수입니다. |
| itemsUpdatesFailed |
integer (int32) |
마지막 동기화에서 실패한 항목 업데이트 수입니다. |
| itemsUpdatesProcessed |
integer (int32) |
마지막 동기화에서 성공적으로 처리된 항목 업데이트 수입니다. |
| startTime |
string (date-time) |
마지막으로 완료된 동기화의 시작 시간입니다. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| info |
추가 정보입니다. |
|
| type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| additionalInfo |
오류 추가 정보입니다. |
|
| code |
string |
오류 코드입니다. |
| details |
오류 세부 정보입니다. |
|
| message |
string |
오류 메시지입니다. |
| target |
string |
오류 대상입니다. |
ErrorResponse
실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.
| Name | 형식 | Description |
|---|---|---|
| error |
오류 개체입니다. |
KnowledgeSourceStatistics
지식 원본 동기화 기록에 대한 통계 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| averageItemsProcessedPerSynchronization |
integer (int32) |
동기화 한 번에 처리된 평균 항목들. |
| averageSynchronizationDuration |
string |
HH:MM:SS 형식의 평균 동기화 시간. |
| totalSynchronization |
integer (int32) |
총 동기화 횟수. |
KnowledgeSourceStatus
참조 자료의 상태 및 동기화 기록을 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| currentSynchronizationState |
여러 인덱서 실행에 걸쳐 있는 현재 동기화 상태입니다. |
|
| lastSynchronizationState |
마지막으로 완료된 동기화에 대한 세부 정보입니다. 첫 번째 동기화에서 Null입니다. |
|
| statistics |
지식 원본 동기화 기록에 대한 통계 정보입니다. 첫 번째 동기화에서 Null입니다. |
|
| synchronizationInterval |
string |
동기화 간격(예: 매일의 경우 '1d'). 일정이 구성되지 않은 경우 Null입니다. |
| synchronizationStatus |
현재 동기화 상태. |
KnowledgeSourceSynchronizationStatus
참조 자료의 현재 동기화 상태입니다.
| 값 | Description |
|---|---|
| creating |
지식 소스가 프로비저닝되고 있습니다. |
| active |
지식 소스가 활성 상태이고 동기화 실행이 발생하고 있습니다. |
| deleting |
참조 자료 원본이 삭제되고 동기화가 일시 중지됩니다. |
SynchronizationState
여러 인덱서 실행에 걸쳐 진행 중인 동기화의 현재 상태를 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| itemsSkipped |
integer (int32) |
현재 동기화에서 건너뛴 항목 수입니다. |
| itemsUpdatesFailed |
integer (int32) |
현재 동기화에서 실패한 항목 업데이트 수입니다. |
| itemsUpdatesProcessed |
integer (int32) |
현재 동기화에서 성공적으로 처리된 항목 업데이트 수입니다. |
| startTime |
string (date-time) |
현재 동기화의 시작 시간입니다. |