功能描述
本接口用于根据指定的条件搜索日志内容。
请求
请求示例
GET /searchlog?logset_id=xxxx-xx-xx-xx-xxxxxxxx&topic_ids=xxxx,xxxx&start_time=2017-08-22%2010%3A10%3A10&end_time=2017-08-23%2010%3A10%3A10&query=&limit=10&context= HTTP/1.1
Host: <Region>.cls.myqcloud.com
Authorization: <AuthorizationString>
请求行
GET /searchlog请求头
除公共头部外，无特殊请求头部。
请求参数
| 字段名 | 类型 | 位置 | 必须 | 含义 |
|---|---|---|---|---|
| logset_id | string | query | 是 | 要查询的 logset id |
| topic_ids | string | query | 是 | 要查询的 topic id 组合，以,分隔 |
| start_time | string | query | 是 | 要查询的日志的起始时间，格式 YYYY-mm-dd HH:MM:SS |
| end_time | string | query | 是 | 要查询的日志的结束时间，格式 YYYY-mm-dd HH:MM:SS |
| query | string | query | 是 | 要查询的内容，详情请参考 检索语法 |
| limit | int | query | 是 | 单次要返回的日志条数，单次返回的最大条数为100 |
| context | string | query | 否 | 加载更多使用，透传上次返回的 context 值，获取后续的日志内容，通过游标最多可获取10000条，请尽可能缩小时间范围 |
| sort | string | query | 否 | 按时间排序 asc（升序）或者 desc（降序），默认为 desc |
响应
响应示例
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 53
{
"context": "abcdefg",
"listover": false,
"results": [
{
"timestamp": "2017-07-14 20:43:00",
"topic_id": "xxxx-xx-xx-xx-xxxxxxxx",
"topic_name": "xxxxxxx",
"content": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
},
{
"timestamp": "2017-07-14 20:42:00",
"topic_id": "xxxx-xx-xx-xx-xxxxxxxx",
"topic_name": "xxxxxxx",
"content": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
]
}响应头
除公共响应头部外，无特殊响应头部。
响应参数
| 字段名 | 类型 | 必有 | 含义 |
|---|---|---|---|
| context | string | 是 | 获取更多检索结果的游标 |
| listover | bool | 是 | 搜索结果是否已经全部返回 |
| results | JsonArray（LogObject） | 是 | 日志内容信息 |
LogObject 格式如下：
| 字段名 | 类型 | 必有 | 含义 |
|---|---|---|---|
| topic_id | string | 是 | 日志属于的 topic id |
| topic_name | string | 是 | 日志主题的名字 |
| timestamp | string | 是 | 日志时间 |
| content | string | 是 | 日志内容 |
| filename | string | 是 | 采集路径 |
| source | string | 是 | 日志来源设备 |
错误码
请参见 错误码。