파서 조회

지정한 파서의 설정을 조회합니다. 전체 파서 목록은 파서 목록 조회 API로 확인할 수 있습니다.

필요 권한

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

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     https://HOSTNAME/api/sonar/parsers/fortigate

요청 매개변수

경로 매개변수

정상 응답

{
  "parser": {
    "code": "fortigate",
    "name": "포티게이트",
    "description": "WELF 형식으로 된 포티게이트 로그를 파싱합니다.",
    "factory_name": "fortigate",
    "factory_display_name": "포티게이트",
    "builtin": true,
    "configs": {
      "ver": "2"
    },
    "created": "2022-09-01 00:31:14+0900",
    "updated": "2022-09-01 00:31:14+0900",
    "app_code": null,
    "app_built_in": null
  }
}

• parser (맵): 파서 정보. 파서가 존재하지 않으면 null.
  • code (문자열): 파서 식별자. parse 명령어에서 파서 호출 시 참조됨.
  • name (문자열): 파서 화면 표시 이름
  • description (문자열): 파서에 대한 설명
  • factory_name (문자열): 파서 유형 식별자
  • factory_display_name (문자열): 파서 유형 화면 표시 이름
  • builtin (불리언): 패키지 내장 파서 여부
  • schema_code (문자열): 정규화 스키마 코드. 정규화 파서의 경우에만 출력됨.
  • schema_name (문자열): 정규화 스키마의 화면 표시 이름. 정규화 파서의 경우에만 출력됨.
  • configs (맵): 파서 유형별 설정 명세에 정의된 설정 키/값
  • created (문자열): 생성일시. yyyy-MM-dd HH:mm:ssZ 형식.
  • updated (문자열): 수정일시. yyyy-MM-dd HH:mm:ssZ 형식.
  • app_code (문자열): 앱 식별자
  • app_built_in (불리언): 앱 내장 객체 여부

오류 응답

파서가 존재하지 않는 경우

HTTP 상태 코드 200 응답

{
  "parser": null
}

권한이 없는 경우

HTTP 상태 코드 500 응답

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