계정 그룹 생성

새 계정 그룹을 생성합니다.

필요 권한

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

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
요청 매개변수
필수타입설명비고
nameO문자열계정 그룹 이름최소 1자, 최대 200자
guidX문자열계정 그룹 GUID36자
company_guidX문자열회사 GUID36자. 클러스터 관리자만 사용 가능
descriptionX문자열설명최대 2,000자
user_guidsX배열계정 식별자 목록유효하지 않은 계정 식별자는 무시됨

정상 응답

{}

오류 응답

필수 매개변수가 누락된 경우
{
  "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."
}