커서 삭제

지정한 쿼리 ID의 서버 커서를 삭제합니다. 쿼리 ID는 커서 생성 API로 발급받습니다.

필요 권한

사용자 이상의 계정이며 본인이 실행한 쿼리만 삭제할 수 있습니다. 클러스터 관리자는 다른 계정이 실행한 쿼리도 삭제할 수 있습니다.

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -X DELETE https://HOSTNAME/api/sonar/cursors/109

요청 매개변수

경로 매개변수

정상 응답

{
    "status": "ok"
}

오류 응답

쿼리가 존재하지 않는 경우

HTTP 상태 코드 403 응답. 커서가 존재하지 않거나 다른 계정에서 실행한 쿼리의 경우 커서를 삭제할 수 없습니다.

{
    "error_code": "invalid-query-id",
    "error_msg": "cannot access query 42"
}

쿼리 ID가 정수가 아닌 경우

HTTP 상태 코드 400 응답

{
    "error_code": "invalid-param-type",
    "error_msg": "query id should be integer type"
}