패턴 그룹 목록 조회

검색 조건과 일치하는 패턴 그룹 목록을 조회합니다.

HTTP 요청

cURL 예시

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

요청 매개변수

정상 응답

{
  "total_count": 23,
  "pattern_groups": [
    {
      "guid": "28ad21b2-585c-4b68-9fad-b78711078496",
      "name": "IPS WAS 취약점 공격 경보",
      "description": "알려진 WAS의 취약점을 이용하여 원격코드 실행하거나 서비스 거부 등을 일으키는 공격 탐지",
      "pattern_count": 15,
      "company_guid": "6fbe27b7-f1ae-4d7a-a1a5-76d8fa9aa311",
      "company_name": "로그프레소",
      "user_guid": "ffaf431b-653a-4329-8f83-913cbb00342d",
      "user_name": "관리자",
      "created": "2022-09-01 00:31:14+0900",
      "updated": "2022-09-01 00:31:14+0900"
    }
  ]
}

• total_count (32비트 정수): 검색 조건과 일치하는 전체 건수
• pattern_groups (배열): 패턴 그룹 목록
  • guid (문자열): 패턴 그룹 GUID
  • name (문자열): 패턴 그룹 이름
  • description (문자열): 패턴 그룹 설명
  • pattern_count (32비트 정수): 패턴 건수
  • company_guid (문자열): 그룹이 속한 회사(테넌트) 식별자
  • company_name (문자열): 그룹이 속한 회사(테넌트) 이름
  • user_guid (문자열): 패턴 그룹을 생성한 계정의 GUID
  • user_name (문자열): 패턴 그룹을 생성한 계정의 성명
  • created (문자열): 생성일시 (yyyy-MM-dd HH:mm:ssZ 형식)
  • updated (문자열): 수정일시 (yyyy-MM-dd HH:mm:ssZ 형식)

오류 응답

offset, limit 값이 정수가 아닌 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'offset' parameter should be int type"
}

offset, limit 값이 음수인 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'offset' must be greater than or equal to 0."
}