보고서 그룹 생성

보고서 그룹을 생성합니다.

필요 권한

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

HTTP 요청

POST /api/sonar/report-groups
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
     -d name="보고서 그룹" \
     -d description="보고서 그룹 설명" \
     -d parent_guid="b5bc3133-b53e-4b61-96b5-8857015a0ede" \
     -X POST https://HOSTNAME/api/sonar/report-groups
요청 매개변수
필수타입설명비고
guidX문자열보고서 그룹 식별자GUID 형식 36자. 기본값은 무작위 생성
nameO문자열보고서 그룹 이름최소 1자, 최대 50자
descriptionX문자열보고서 그룹 설명최대 2,000자
parent_guidX문자열상위 보고서 그룹 식별자GUID 형식 36자

정상 응답

{}

오류 응답

필수 매개변수가 누락된 경우

HTTP 상태 코드 400 응답

{
    "error_code": "null-argument",
    "error_msg": "name should be not null"
}
매개변수 값의 길이가 잘못된 경우

HTTP 상태 코드 400 응답

{
    "error_code": "invalid-argument",
    "error_msg": "'name' must be shorter than or equal to 50 characters."
}
식별자가 GUID 형식이 아닌 경우

HTTP 상태 코드 400 응답

{
    "error_code": "invalid-param-type",
    "error_msg": "guid should be guid type."
}
상위 보고서 그룹이 존재하지 않는 경우

HTTP 상태 코드 500 응답

{
    "error_code": "illegal-state",
    "error_msg": "parent group not found: 05efb651-9644-4518-950f-dbd648c973a7"
}
보고서 그룹 생성 권한이 없는 경우

HTTP 상태 코드 500 응답

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