테이블 그룹 조회

GUID로 식별되는 테이블 그룹을 조회합니다.

필요 권한

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

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     "https://HOSTNAME/api/sonar/table-groups/:guid"

요청 매개변수

정상 응답

{
  "table_group": {
    "guid": "bb994ca4-1471-4b91-89f2-99a61bd529b5",
    "name": "table_example",
    "description": "테이블 예시",
    "parent_guid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "created": "2024-12-18 20:53:51+0900",
    "updated": "2024-12-18 20:54:15+0900"
  }
}

• table_group (맵): 테이블 그룹 정보
  • guid (문자열): 테이블 그룹 GUID
  • name (문자열): 테이블 그룹 이름
  • description (문자열): 테이블 그룹 정의
  • parent_guid (문자열): 부모 테이블 그룹 GUID
  • created (문자열): 생성일시 (yyyy-MM-dd HH:mm:ssZ 형식)
  • updated (문자열): 수정일시 (yyyy-MM-dd HH:mm:ssZ 형식)

오류 응답

테이블 그룹이 존재하지 않는 경우

HTTP 상태 코드 200 응답

{
  "table_group": null
}

guid가 GUID 형식이 아닌 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-param-type",
  "error_msg": "guid should be guid type."
}

권한이 없는 경우

HTTP 상태 코드 500

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