테이블 이동

하나 이상의 테이블을 지정한 테이블 그룹으로 이동합니다. group_guid를 지정하지 않으면 테이블이 최상위(루트) 그룹으로 이동합니다.

필요 권한

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

HTTP 요청

PUT /api/sonar/tables/move

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -d table_names=evtx_system,evtx_security \
     -d group_guid=12345678-1234-5678-9012-123456789012 \
     -X PUT \
     https://HOSTNAME/api/sonar/tables/move

요청 매개변수

키	필수	타입	설명	비고
table_names	O	문자열 목록	이동할 테이블 이름 목록	쉼표(`,`)로 구분. 각 항목은 대소문자 구분
group_guid	X	문자열	대상 테이블 그룹 GUID	36자 GUID. 미지정 시 최상위(루트) 그룹으로 이동

Tip

존재하지 않는 테이블 이름은 이동 대상에서 제외되며, 정상 응답 본문에는 표시되지 않습니다.

정상 응답

{}

오류 응답

table_names가 누락된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "null-argument",
  "error_msg": "table_names should be not null"
}

group_guid가 GUID 형식이 아닌 경우

HTTP 상태 코드 400 응답

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

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

HTTP 상태 코드 200 응답

{
  "failures": [
    {
      "id": "12345678-1234-5678-9012-123456789012",
      "reason": "table-group-not-found [guid: 12345678-1234-5678-9012-123456789012]"
    }
  ]
}

failures (배열): 이동에 실패한 항목 목록
- id (문자열): 존재하지 않는 대상 테이블 그룹 GUID
- reason (문자열): 실패 사유

권한이 없는 경우

HTTP 상태 코드 500 응답

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