패턴 목록 조회

지정한 패턴 그룹에 속한 패턴 목록을 조회합니다.

필요 권한

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

HTTP 요청

GET /api/sonar/pattern-groups/:guid/patterns
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
     https://HOSTNAME/api/sonar/pattern-groups/8df64276-a16e-4bae-93cd-c207c8155159/patterns
요청 매개변수
필수타입설명비고
guidO문자열패턴 그룹 GUID36자
offsetX32비트 정수건너뛸 갯수기본값 0
limitX32비트 정수최대 갯수미지정 시 20건
keywordsX문자열검색 키워드rule, expr, expr2 대상으로 검색

정상 응답

{
    "total_count": 2,
    "patterns": [
        {
            "id": 112,
            "expr": "\"passwd\"",
            "expr2": "path == \"*passwd\"",
            "rule": "/etc/passwd",
            "created": "2022-09-01 00:31:14+0900",
            "updated": "2022-09-01 00:31:14+0900"
        },
        {
            "id": 113,
            "expr": "\"authorized_keys\"",
            "expr2": "path == \"*authorized_keys\"",
            "rule": "/.ssh/authorized_keys",
            "created": "2022-09-01 00:31:14+0900",
            "updated": "2022-09-01 00:31:14+0900"
        }
    ]
]
  • total_count (32비트 정수): 검색 조건과 일치하는 전체 패턴 수
  • patterns (배열): 패턴 목록
    • id (32비트 정수): 패턴 ID
    • expr (문자열): 키워드 불린 표현식
    • expr2 (문자열): 검증식. 키워드 매치된 결과에 대하여 필터링 수행
    • rule (문자열): 패턴명
    • 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."
}