> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/back-office-api/system-bo-api/undefined-20.md).

# 배치로그 조회

## 배치상태 변경 처리

> \## 기능설명\
> \* 진행 중인 배치를 실패 상태로 변경 처리합니다.\
> \---\
> \## 상세설명\
> \* 진행 중인 배치의 상태를 FAILED 처리해 재실행할 수 있는 상태로 만듭니다.\
> \* 배치로그 메세지를 '관리자가 상태변경'로 변경합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"StBatchLogRequest":{"type":"object","description":"배치 결과 수정 요청 DTO","properties":{"jobExecutionId":{"type":"integer","format":"int64","description":"JOB실행 ID"}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/system/batchLog/modifyBatchLogStatus":{"post":{"tags":["배치로그 조회"],"summary":"배치상태 변경 처리","description":"## 기능설명\n* 진행 중인 배치를 실패 상태로 변경 처리합니다.\n---\n## 상세설명\n* 진행 중인 배치의 상태를 FAILED 처리해 재실행할 수 있는 상태로 만듭니다.\n* 배치로그 메세지를 '관리자가 상태변경'로 변경합니다.\n","operationId":"modifyBatchLogStatus","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StBatchLogRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 배치로그 목록 조회

> \## 기능설명\
> \* 기준일자, 배치프로그램, 배치결과에 맞는 배치로그 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 기준일자, 배치프로그램, 배치결과에 맞는 배치로그 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240530: 날짜조회 쿼리 변경\
> \---\
> \## 특이사항\
> \* 배치결과 코드: COMPLETED, FAILED, STARTED<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"StBatchLogRequest":{"type":"object","description":"배치 결과 수정 요청 DTO","properties":{"jobExecutionId":{"type":"integer","format":"int64","description":"JOB실행 ID"}}},"RealGridListResponseStBatchLogResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/StBatchLogResponse"}}}},"StBatchLogResponse":{"type":"object","description":"배치로그 조회 응답 DTO","properties":{"batchLogSeq":{"type":"string","description":"배치로그순번"},"batchNo":{"type":"string","description":"배치번호"},"stdDt":{"type":"string","description":"기준일자"},"batchPgmNm":{"type":"string","description":"배치프로그램명"},"batchRsltCd":{"type":"string","description":"배치결과코드"},"batchLogCont":{"type":"string","description":"배치로그"},"batchStrDtm":{"type":"string","format":"date-time","description":"배치시작일시"},"batchEndDtm":{"type":"string","format":"date-time","description":"배치종료일시"},"jobExecutionId":{"type":"integer","format":"int64","description":"JOB 실행 ID"},"batchStatusUpdate":{"type":"string","description":"배치결과변경문구"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/system/batchLog/getBatchLogList":{"get":{"tags":["배치로그 조회"],"summary":"배치로그 목록 조회","description":"## 기능설명\n* 기준일자, 배치프로그램, 배치결과에 맞는 배치로그 목록을 조회합니다.\n---\n## 상세설명\n* 기준일자, 배치프로그램, 배치결과에 맞는 배치로그 목록을 조회합니다.\n---\n## 수정번호\n* Release v2.00_240530: 날짜조회 쿼리 변경\n---\n## 특이사항\n* 배치결과 코드: COMPLETED, FAILED, STARTED\n","operationId":"getBatchList","parameters":[{"name":"stBatchLogRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/StBatchLogRequest"}},{"name":"stdDt","in":"query","description":"기준일자","schema":{"type":"LocalDate"}},{"name":"batchPgmNm","in":"query","description":"배치프로그램명","schema":{"type":"string"}},{"name":"batchRsltCd","in":"query","description":"배치결과","schema":{"type":"string"}},{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"string"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseStBatchLogResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```