콘텐츠로 이동

데이터 쿼리 태스크 생성¶

POST /api/v1/log_backup_cfg/query_task

개요¶

데이터 전송 비동기 쿼리 태스크를 생성하고, 쿼리 태스크 ID를 반환합니다. 해당 ID는 이후 태스크 상태 조회에 사용할 수 있습니다. 참고: 단일 쿼리에서 최대 10개의 파일을 검색할 수 있습니다. 더 많은 파일을 조회하려면 token 파라미터를 포함하여 다시 호출하십시오. token 값은 이전 쿼리 응답에서 반환된 값입니다.

Body 요청 파라미터¶

파라미터명	유형	필수	설명
name	string	Y	규칙명 빈 값 허용: False
search	json		검색(정규식만 지원) 빈 값 허용: False
startTime	string	Y	시작 시간(밀리초 단위 타임스탬프, 문자열) 예시: 1763542157000 빈 값 허용: False
endTime	string	Y	종료 시간(밀리초 단위 타임스탬프, 문자열) 예시: 1763542157000 빈 값 허용: False
token	string		쿼리 커서로, 페이지를 넘겨 조회하려면 이전 요청 결과의 token을 포함해야 함 빈 값 허용: False 빈 문자열 허용: True
topN	integer		페이지당 반환 개수 빈 값 허용: False 예시: 10 $minValue: 1 $maxValue: 1000
dataType	string		데이터 유형 빈 값 허용: False 빈 문자열 허용: True 선택 가능 값: ['llm', 'logging', 'tracing', 'rum', 'keyevent', 'audit_event', 'am']

파라미터 보충 설명¶

search 요청 파라미터 설명

파라미터명	type	설명
conditions	array[json]	쿼리 조건으로, 각 조건은 key, value, logic 필드를 포함하는 json 객체
operator	string	논리 연산자, 선택 가능 값: and, or

conditions 파라미터 설명

파라미터명	type	설명
key	string	필드명
value	string	필드값
logic	string	논리 연산자, 선택 가능 값: match, notMatch

요청 예시¶

curl 'https://openapi.guance.com/api/v1/log_backup_cfg/query_task' \
-H 'Accept: application/json, text/plain, */*' \
-H 'Content-Type: application/json;charset=UTF-8' \
-H 'DF-API-KEY: <DF-API-KEY>' \
--data-raw '{"name":"xxx-test","dataType":"logging","startTime":"1764000000000","endTime":"1764037304000","search":"","topN":50}' \
--compressed

응답¶

{
    "code": 200,
    "content": {
        "task_id": "d4ih5flt3l333a0ulmu0:a29kby14LWJhY2t1cGxvZy0w"
    },
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "087552ec57015df654c5eaefdd604305"
}