수집기 그룹 생성
새 수집기 그룹을 생성합니다. 이 작업은 관리자 권한을 요구합니다.
HTTP 요청
POST /api/sonar/logger-groups
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
-d name="Firewall" \
-X POST https://HOSTNAME/api/sonar/logger-groups
요청 매개변수
| 키 | 필수 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| guid | X | 문자열 | 수집기 그룹 식별자 | 36자 GUID. 미설정 시 무작위 생성 |
| name | O | 문자열 | 수집기 그룹 이름 | 최소 1자, 최대 50자 |
| description | X | 문자열 | 수집기 그룹 설명 | 최대 2,000자 |
| parent_guid | X | 문자열 | 부모 수집기 그룹 식별자 | 36자 GUID |
정상 응답
{
"guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
오류 응답
필수 매개변수가 누락된 경우
HTTP 상태 코드 400 응답.
{
"error_code": "null-argument",
"error_msg": "name should be not null"
}
매개변수 값의 길이가 잘못된 경우
HTTP 상태 코드 400 응답.
{
"error_code": "invalid-argument",
"error_msg": "'name' must be less than or equal to 50 characters."
}
관리 권한이 없는 경우
HTTP 상태 코드 500 응답.
{
"error_code": "illegal-state",
"error_msg": "no-permission"
}