패턴 목록 조회
지정한 패턴 그룹에 속한 패턴 목록을 조회합니다.
필요 권한
사용자 이상의 계정으로 이용할 수 있습니다.
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
요청 매개변수
| 키 | 필수 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| guid | O | 문자열 | 패턴 그룹 GUID | 36자 |
| offset | X | 32비트 정수 | 건너뛸 갯수 | 기본값 0 |
| limit | X | 32비트 정수 | 최대 갯수 | 미지정 시 20건 |
| keywords | X | 문자열 | 검색 키워드 | 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."
}