룩업 일괄 삭제

지정한 여러 룩업을 일괄 삭제합니다. 일부 항목의 삭제 실패를 허용하며, 실패한 항목은 응답의 failures 배열에 식별자와 실패 원인으로 반환됩니다.

필요 권한

관리자 이상의 계정으로 이용할 수 있습니다.

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -d 'guids=76b8699d-91a1-4576-a908-7db753570a0a,4ab572a7-f052-4f90-82db-320444e229a3' \
     -X DELETE \
     https://HOSTNAME/api/sonar/lookups

요청 매개변수

정상 응답

삭제에 실패한 항목이 없으면 failures 배열이 비어 있습니다.

{
  "failures": []
}

일부 항목의 삭제가 실패하면 해당 항목이 failures 배열에 반환됩니다.

{
  "failures": [
    {
      "id": "4ab572a7-f052-4f90-82db-320444e229a3",
      "reason": "lookup not found: 4ab572a7-f052-4f90-82db-320444e229a3"
    }
  ]
}

• failures (배열): 삭제에 실패한 항목 목록. 모두 성공하면 빈 배열
  • id (문자열): 삭제에 실패한 룩업 GUID
  • reason (문자열): 실패 원인. 지정한 룩업이 없으면 lookup not found: <GUID>, 데이터베이스 처리 오류면 sql-error

오류 응답

guids가 누락된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "null-argument",
  "error_msg": "guids should be not null"
}

식별자가 GUID 형식이 아닌 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-param-type",
  "error_msg": "guids should be guid type."
}

권한이 없는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "no-permission"
}