커서 생성

백그라운드 모드로 쿼리를 시작하고 서버 커서를 반환합니다.

Note
커서 사용이 끝나면 반드시 커서를 삭제해야 합니다. 사용되지 않고 남아있는 커서는 로그프레소 서버의 힙 메모리를 불필요하게 점유합니다.

HTTP 요청

POST /api/sonar/cursors
요청 매개변수
필수타입설명비고
qO문자열로그프레소 쿼리 문자열

정상 응답

{ "id": 109 }
  • id (32비트 정수): 백그라운드 모드로 생성된 쿼리 ID

오류 응답

쿼리 매개변수가 누락된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "null-argument",
  "error_msg": "q should be not null"
}
쿼리가 잘못된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-query",
  "error_msg": "(10200) missing-json-quotation"
}