Indexers - Get Status
인덱서의 현재 상태 및 실행 기록을 반환합니다.
GET {endpoint}/indexers('{indexerName}')/search.status?api-version=2025-09-01
URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string |
검색 서비스의 엔드포인트 URL입니다. |
|
indexer
|
path | True |
string |
상태를 검색할 인덱서의 이름입니다. |
|
api-version
|
query | True |
string |
클라이언트 API 버전입니다. |
요청 헤더
| Name | 필수 | 형식 | Description |
|---|---|---|---|
| x-ms-client-request-id |
string (uuid) |
디버깅을 돕기 위해 요청과 함께 전송된 추적 ID입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK | ||
| Other Status Codes |
오류 응답입니다. |
예제
SearchServiceGetIndexerStatus
샘플 요청
GET https://stableexampleservice.search.windows.net/indexers('myindexer')/search.status?api-version=2025-09-01
샘플 응답
{
"name": "myindexer",
"status": "running",
"lastResult": {
"status": "success",
"startTime": "2014-11-26T03:37:18.853Z",
"endTime": "2014-11-26T03:37:19.012Z",
"itemsProcessed": 11,
"itemsFailed": 0,
"errors": [],
"warnings": []
},
"executionHistory": [
{
"status": "success",
"startTime": "2014-11-26T03:37:18.853Z",
"endTime": "2014-11-26T03:37:19.012Z",
"itemsProcessed": 11,
"itemsFailed": 0,
"errors": [],
"warnings": []
},
{
"status": "transientFailure",
"startTime": "2014-11-26T03:28:10.125Z",
"endTime": "2014-11-26T03:28:12.007Z",
"itemsProcessed": 1,
"itemsFailed": 2,
"errors": [
{
"key": "",
"statusCode": 400,
"errorMessage": "Document key cannot be missing or empty."
},
{
"key": "document id 1",
"statusCode": 400,
"name": "DocumentExtraction.AzureBlob.MyDataSource",
"errorMessage": "Could not read the value of column 'foo' at index '0'.",
"details": "The file could not be parsed.",
"documentationLink": "https://go.microsoft.com/fwlink/?linkid=2049388"
}
],
"warnings": [
{
"key": "document id",
"message": "A warning doesn't stop indexing, and is intended to inform you of certain interesting situations, like when a blob indexer truncates the amount of text extracted from a blob."
},
{
"key": "document id 2",
"name": "Enrichment.LanguageDetectionSkill.#4",
"message": "Document was truncated to 50000 characters.",
"details": "The skill did something that didn't break anything, nonetheless something we didn't expect happened, so it might be worth double checking.",
"documentationLink": "https://go.microsoft.com/fwlink/?linkid=2099692"
}
]
}
],
"limits": {
"maxRunTime": "PT22H",
"maxDocumentExtractionSize": 256000000,
"maxDocumentContentCharactersToExtract": 4000000
}
}
정의
| Name | Description |
|---|---|
|
Error |
리소스 관리 오류 추가 정보입니다. |
|
Error |
오류 세부 정보입니다. |
|
Error |
오류 응답 |
|
Indexer |
개별 인덱서 실행 결과를 나타냅니다. |
|
Indexer |
개별 인덱서 실행의 상태를 나타냅니다. |
|
Indexer |
전체 인덱서 상태를 나타냅니다. |
|
Search |
항목 또는 문서 수준 인덱싱 오류를 나타냅니다. |
|
Search |
|
|
Search |
인덱서의 현재 상태 및 실행 기록을 나타냅니다. |
|
Search |
항목 수준 경고를 나타냅니다. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| info |
object |
추가 정보입니다. |
| type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| additionalInfo |
오류 추가 정보입니다. |
|
| code |
string |
오류 코드입니다. |
| details |
오류 세부 정보입니다. |
|
| message |
string |
오류 메시지입니다. |
| target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
| Name | 형식 | Description |
|---|---|---|
| error |
오류 개체입니다. |
IndexerExecutionResult
개별 인덱서 실행 결과를 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| endTime |
string (date-time) |
실행이 이미 완료된 경우 이 인덱서 실행의 종료 시간입니다. |
| errorMessage |
string |
최상위 오류를 나타내는 오류 메시지(있는 경우)입니다. |
| errors |
항목 수준 인덱싱 오류입니다. |
|
| finalTrackingState |
string |
인덱서 실행이 완료된 추적 상태를 변경합니다. |
| initialTrackingState |
string |
인덱서 실행이 시작된 추적 상태를 변경합니다. |
| itemsFailed |
integer (int32) |
이 인덱서 실행 중에 인덱싱하지 못한 항목 수입니다. |
| itemsProcessed |
integer (int32) |
이 인덱서 실행 중에 처리된 항목 수입니다. 여기에는 성공적으로 처리된 항목과 인덱싱을 시도했지만 실패한 항목이 모두 포함됩니다. |
| startTime |
string (date-time) |
이 인덱서 실행의 시작 시간입니다. |
| status |
이 인덱서 실행의 결과입니다. |
|
| warnings |
항목 수준 인덱싱 경고입니다. |
IndexerExecutionStatus
개별 인덱서 실행의 상태를 나타냅니다.
| 값 | Description |
|---|---|
| transientFailure |
인덱서 호출이 실패했지만 실패가 일시적일 수 있습니다. 인덱서 호출은 일정에 따라 계속됩니다. |
| success |
인덱서 실행이 성공적으로 완료되었습니다. |
| inProgress |
인덱서 실행이 진행 중입니다. |
| reset |
인덱서가 다시 설정되었습니다. |
IndexerStatus
전체 인덱서 상태를 나타냅니다.
| 값 | Description |
|---|---|
| unknown |
인덱서가 알 수 없는 상태임을 나타냅니다. |
| error |
인덱서에 사람의 개입 없이는 수정할 수 없는 오류가 발생했음을 나타냅니다. |
| running |
인덱서가 정상적으로 실행되고 있음을 나타냅니다. |
SearchIndexerError
항목 또는 문서 수준 인덱싱 오류를 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| details |
string |
인덱서 디버깅을 돕기 위해 오류에 대한 자세한 세부 정보가 추가로 제공됩니다. 항상 사용할 수 있는 것은 아닙니다. |
| documentationLink |
string |
이러한 오류 클래스에 대한 문제 해결 가이드에 대한 링크입니다. 항상 사용할 수 있는 것은 아닙니다. |
| errorMessage |
string |
항목을 처리하는 동안 발생한 오류를 설명하는 메시지입니다. |
| key |
string |
인덱싱에 실패한 항목의 키입니다. |
| name |
string |
오류가 발생한 소스의 이름입니다. 예를 들어 연결된 기술 세트의 특정 기술을 참조할 수 있습니다. 항상 사용할 수 있는 것은 아닙니다. |
| statusCode |
integer (int32) |
인덱싱 작업이 실패한 이유를 나타내는 상태 코드입니다. 가능한 값은 형식이 잘못된 입력 문서의 경우 400, 문서를 찾을 수 없는 경우 404, 버전 충돌의 경우 409, 인덱스를 일시적으로 사용할 수 없는 경우 422 또는 서비스가 너무 사용 중인 경우 503입니다. |
SearchIndexerLimits
| Name | 형식 | Description |
|---|---|---|
| maxDocumentContentCharactersToExtract |
number (int64) |
인덱싱을 위해 선택한 문서에서 추출될 최대 문자 수입니다. |
| maxDocumentExtractionSize |
number (int64) |
인덱싱에 유효한 것으로 간주되는 문서의 최대 크기(바이트)입니다. |
| maxRunTime |
string (duration) |
인덱서가 한 번의 실행에 대해 실행될 수 있는 최대 기간입니다. |
SearchIndexerStatus
인덱서의 현재 상태 및 실행 기록을 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| executionHistory |
최근 인덱서 실행 기록은 시간 역순으로 정렬됩니다. |
|
| lastResult |
가장 최근 또는 진행 중인 인덱서 실행의 결과입니다. |
|
| limits |
인덱서에 대한 실행 제한입니다. |
|
| name |
string |
인덱서의 이름입니다. |
| status |
전체 인덱서 상태입니다. |
SearchIndexerWarning
항목 수준 경고를 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| details |
string |
인덱서 디버깅을 지원하는 경고에 대한 자세한 추가 세부 정보입니다. 항상 사용할 수 있는 것은 아닙니다. |
| documentationLink |
string |
이러한 경고 클래스에 대한 문제 해결 가이드에 대한 링크입니다. 항상 사용할 수 있는 것은 아닙니다. |
| key |
string |
경고를 생성한 항목의 키입니다. |
| message |
string |
항목을 처리하는 동안 발생한 경고를 설명하는 메시지입니다. |
| name |
string |
경고가 시작된 소스의 이름입니다. 예를 들어 연결된 기술 세트의 특정 기술을 참조할 수 있습니다. 항상 사용할 수 있는 것은 아닙니다. |