테이블 그룹 생성

새 테이블 그룹을 생성합니다. 이 작업은 관리자 권한을 요구합니다.

HTTP 요청

POST /api/sonar/table-groups
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
     -d name="table_example" \
     -d description="테이블 예시 그룹" \
     -d parent_guid="54157629-74f7-4d80-be5a-8cb8f0c71087" \
     -X POST "https://HOSTNAME/api/sonar/table-groups"
요청 매개변수
필수타입설명비고
nameO문자열테이블 그룹 이름최소 1자, 최대 50자
descriptionX문자열테이블 그룹 설명최대 2,000자
guidX문자열테이블 그룹 GUID36자 GUID. 미설정 시 무작위 생성
parent_guidX문자열부모 테이블 그룹 GUID36자 GUID

정상 응답

{
  "guid": "0157fda0-15ed-49f5-acd8-e0ada14c196a"
}

오류 응답

guid가 GUID 형식이 아닌 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-param-type",
  "error_msg": "guid should be guid type."
}
name이 중복된 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "duplicated-name [name: table_example]"
}
name이 누락된 경우

HTTP 상태 코드 400 응답

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

최소 길이보다 짧은 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'name' must be longer than or equal to 1 characters."
}

최대 길이보다 긴 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'name' must be shorter than or equal to 50 characters."
}
description 값의 길이가 잘못된 경우

HTTP 상태 코드 400 응답

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

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-param-type",
  "error_msg": "parent_guid should be guid type."
}
parent_guid가 존재하지 않는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "parent-table-group-not-found [guid: 54157629-74f7-4d80-be5a-8cb8f0c71087]"
}
관리 권한이 없는 경우

HTTP 상태 코드 500 응답

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