테이블 목록 조회
검색 조건과 일치하는 로그프레소 소나의 테이블 목록을 조회합니다.
Tip
동일 인스턴스라도 로그프레소 엔터프라이즈에서 생성한 테이블은 로그프레소 소나에 구성 정보가 없으므로 표시되지 않습니다.
HTTP 요청
GET /api/sonar/tables
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
https://HOSTNAME/api/sonar/tables
요청 매개변수
키 | 필수 | 타입 | 설명 | 비고 |
---|---|---|---|---|
offset | X | 32비트 정수 | 건너뛸 갯수 | 기본값 0 |
limit | X | 32비트 정수 | 최대 갯수 | 기본값 2147483647 |
keywords | X | 문자열 | 검색 키워드 | table_name 대상으로 검색 |
company_guid | X | 문자열 | 회사 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."
}