자산 IP 취약점 수정

지정한 자산 IP 취약점의 정보를 수정합니다.

필요 권한

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

HTTP 요청

PUT /api/sonar/ip-address-vulnerabilities/:guid

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -d cve_id="CVE-2024-12345" \
     -d status="IN_PROGRESS" \
     -d emp_guid="8d352716-cc2e-4e9b-8e00-4cc707ef78fe" \
     -X PUT \
     https://HOSTNAME/api/sonar/ip-address-vulnerabilities/9c4e2f3a-1b2d-4c5e-9f8a-3d2c1b4a5e6f

요청 매개변수

키	필수	타입	설명	비고
guid	O	문자열	자산 IP 취약점 GUID	36자
cve_id	O	문자열	CVE 식별자	`CVE-YYYY-NNNN` 형식
status	X	문자열	처리 상태	`UNRESOLVED`, `REVIEWING`, `IN_PROGRESS`, `RISK_ACCEPTED`, `RESOLVED`. 기본값: `UNRESOLVED`
emp_guid	X	문자열	담당자 GUID	36자
diagnosis	X	문자열	진단 일시	`yyyy-MM-dd HH:mm:ssZ` 형식. 미설정 시 현재 시각
scheduled	X	문자열	조치 예정일	`yyyy-MM-dd HH:mm:ssZ` 형식
completed	X	문자열	조치 완료 일시	`yyyy-MM-dd HH:mm:ssZ` 형식

정상 응답

{}

오류 응답

필수 매개변수가 누락된 경우

HTTP 상태 코드 400 응답

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

CVE 식별자 형식이 유효하지 않은 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-argument",
  "error_msg": "invalid cve format: CVE-XXXX"
}

처리 상태 값이 유효하지 않은 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-argument",
  "error_msg": "No enum constant com.logpresso.sonar.api.asset.IpAddressVulnerabilityStatus.INVALID"
}

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

HTTP 상태 코드 400 응답

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

자산 IP 취약점이 존재하지 않는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "ip address vulnerability not found"
}

권한이 없는 경우

HTTP 상태 코드 500 응답

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