테이블 이동

여러 테이블을 지정한 테이블 그룹으로 일괄 이동합니다. group_guid를 비워 두면 테이블이 루트 그룹으로 이동합니다. 이 작업은 관리자 권한을 요구합니다.

필요 권한

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

HTTP 요청

PUT /api/sonar/tables/move
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
     -H "Content-Type: application/json" \
     -X PUT \
     -d '{"group_guid": "12345678-1234-5678-9012-123456789012", "table_names": ["demo", "evtx_system"]}' \
     "https://HOSTNAME/api/sonar/tables/move"
요청 매개변수
키필수타입설명비고
group_guid 문자열대상 테이블 그룹 GUID미지정 시 루트 그룹으로 이동
table_namesO문자열 배열이동할 테이블 이름 목록각 항목 대소문자 구분

정상 응답

{}

오류 응답

table_names가 누락된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "null-argument",
  "error_msg": "table_names should be not null"
}
대상 그룹이 존재하지 않는 경우

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"
}