테이블 목록 조회

검색 조건과 일치하는 로그프레소 소나의 테이블 목록을 조회합니다.

Tip
동일 인스턴스라도 로그프레소 엔터프라이즈에서 생성한 테이블은 로그프레소 소나에 구성 정보가 없으므로 표시되지 않습니다.

HTTP 요청

GET /api/sonar/tables
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
     https://HOSTNAME/api/sonar/tables
요청 매개변수
필수타입설명비고
offsetX32비트 정수건너뛸 갯수기본값 0
limitX32비트 정수최대 갯수기본값 2147483647
keywordsX문자열검색 키워드table_name 대상으로 검색
company_guidX문자열회사 GUID클러스터 관리자의 경우 특정 회사로 결과 한정

정상 응답

{
  "total_count": 1,
  "tables": [
    {
      "company_guid": "6fbe27b7-f1ae-4d7a-a1a5-76d8fa9aa311",
      "company_name": "Logpresso",
      "table_name": "evtx_system",
      "layout": "columnar",
      "compression": "snappy",
      "retention": 180,
      "min_day": "2021-10-19 00:00:00+0900",
      "max_day": "2022-09-14 00:00:00+0900",
      "table_size": 7195337,
      "index_size": 0,
      "ratio": 100
    }
  ]
}
  • total_count (32비트 정수): 검색 결과와 일치하는 전체 건수
  • tables (배열): 테이블 목록
    • company_guid (문자열): 회사 (테넌트) 식별자
    • company_name (문자열): 회사 (테넌트) 이름
    • table_name (문자열): 테이블 이름
    • layout (문자열): 블록 레이아웃
    • compression (문자열): 압축 알고리즘
    • crypto_profile_guid (문자열): 암호화 프로파일 식별자
    • crypto_profile_name (문자열): 암호화 프로파일 이름
    • min_day (문자열): 저장된 최소 로그 날짜 (_time 필드 기준)
    • max_day (문자열): 저장된 최대 로그 날짜 (_time 필드 기준)
    • table_size (64비트 정수): 테이블 데이터 크기 (바이트 단위)
    • index_size (64비트 정수): 인덱스 데이터 크기 (바이트 단위)
    • retention (32비트 정수): 일 단위 데이터 보관 기간
    • ratio (64비트 실수): 스토리지 사용 비율

오류 응답

offset, limit 값이 정수가 아닌 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'offset' parameter should be int type"
}
offset, limit 값이 음수인 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'offset' must be greater than or equal to 0."
}
식별자가 GUID 형식이 아닌 경우

HTTP 상태 코드 400 응답

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