계정 그룹 생성
새 계정 그룹을 생성합니다.
필요 권한
관리자 이상의 계정으로 이용할 수 있습니다.
HTTP 요청
POST /api/sonar/user-groups
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
-d name="Cyber Security" \
-X POST \
https://HOSTNAME/api/sonar/user-groups
요청 매개변수
| 키 | 필수 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| name | O | 문자열 | 계정 그룹 이름 | 최소 1자, 최대 200자 |
| guid | X | 문자열 | 계정 그룹 GUID | 36자 |
| company_guid | X | 문자열 | 회사 GUID | 36자. 클러스터 관리자만 사용 가능 |
| description | X | 문자열 | 설명 | 최대 2,000자 |
| user_guids | X | 배열 | 계정 식별자 목록 | 유효하지 않은 계정 식별자는 무시됨 |
정상 응답
{}
오류 응답
필수 매개변수가 누락된 경우
{
"error_code": "null-argument",
"error_msg": "name should be not null"
}
매개변수 값의 길이가 잘못된 경우
{
"error_code": "invalid-argument",
"error_msg": "'name' must be shorter than or equal to 200 characters."
}
계정 식별자가 GUID 형식이 아닌 경우
{
"error_code": "invalid-param-type",
"error_msg": "user_guids should be guid type."
}