创建数据查询任务¶

POST /api/v1/log_backup_cfg/query_task

概述¶

创建数据转发异步查询任务，返回查询任务id，查询任务id后续可用于查询任务状态。注意：单次查询最多检索10个文件，如需查询更多文件，请携带token参数再次调用，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 可选值: ['logging', 'tracing', 'rum', 'keyevent', 'audit_event']

参数补充说明¶

search 请求参数说明

参数名	type	说明
conditions	array[json]	查询条件，每个条件为一个json对象，包含字段：key, value, logic
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"
}