테이블 이동

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

필요 권한

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

HTTP 요청

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"

요청 매개변수

정상 응답

{
  "failures": []
}

• failures (배열): 실패한 항목 및 사유 목록 (없으면 빈 배열)
  • id (문자열): 실패한 테이블 이름 또는 그룹 GUID
  • reason (문자열): 실패 사유

오류 응답

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

일부 테이블이 존재하지 않는 경우

HTTP 상태 코드 200 응답

{
  "failures": [
    {
      "id": "missing_table",
      "reason": "table-not-found"
    }
  ]
}

권한이 없는 경우

HTTP 상태 코드 500 응답

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