패턴 추가
지정한 패턴 그룹에 새 패턴을 추가합니다. 등록된 패턴 목록은 패턴 목록 조회 API로 확인할 수 있습니다.
필요 권한
관리자 이상의 계정으로 이용할 수 있습니다.
HTTP 요청
POST /api/sonar/pattern-groups/:guid/patterns
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
-d 'expr="/.git/HEAD"' \
-d 'rule=/.git/HEAD file scan' \
-X POST \
https://HOSTNAME/api/sonar/pattern-groups/28ad21b2-585c-4b68-9fad-b78711078496/patterns
요청 매개변수
경로 매개변수
| 키 | 타입 | 설명 | 비고 |
|---|---|---|---|
| guid | 문자열 | 패턴 그룹 GUID | 36자 |
요청 본문 매개변수
| 키 | 필수 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| expr | O | 문자열 | 키워드 검색 표현식 | 최소 3자, 최대 1,000자 |
| expr2 | X | 문자열 | 필터 표현식 | 최소 1자, 최대 1,000자 |
| rule | O | 문자열 | 패턴명 | 최대 1,000자 |
정상 응답
{}
오류 응답
필수 매개변수가 누락된 경우
HTTP 상태 코드 400 응답
{
"error_code": "null-argument",
"error_msg": "expr should be not null"
}
expr 값의 길이가 잘못된 경우
HTTP 상태 코드 400 응답
{
"error_code": "invalid-argument",
"error_msg": "'expr' must be longer than or equal to 3 characters."
}
키워드 검색 표현식 문법이 잘못된 경우
HTTP 상태 코드 400 응답
{
"error_code": "invalid-argument",
"error_msg": "expr syntax error: not-quoted"
}
필터 표현식 문법이 잘못된 경우
HTTP 상태 코드 400 응답
{
"error_code": "invalid-argument",
"error_msg": "expr2 syntax error: path =="
}
패턴 그룹이 존재하지 않는 경우
HTTP 상태 코드 500 응답
{
"error_code": "illegal-state",
"error_msg": "pattern group not found: 28ad21b2-585c-4b68-9fad-b78711078496"
}
권한이 없는 경우
HTTP 상태 코드 500 응답
{
"error_code": "illegal-state",
"error_msg": "no-permission"
}