# 获取快速查询 - ListCriterias #### 功能介绍 获取快速查询。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-lts/lts_api_0003.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-lts/lts_api_0046.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | lts:logStream:listQuickQuery | List | logGroup \* | g:ResourceTag/\ | lts:searchcriterias:list | - | #### URI GET /v1.0/{project_id}/groups/{group_id}/topics/{topic_id}/search-criterias 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目ID，可以从调用API处获取，也可以从控制台获取。获取方式请参见：[获取项目ID](https://support.huaweicloud.com/api-lts/lts_api_0006.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | group_id | 是 | String | **参数解释：** 待查询日志流所在的日志组ID，获取方式请参见：[获取日志组ID和日志流ID](https://support.huaweicloud.com/api-lts/lts_api_0014.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | topic_id | 是 | String | **参数解释：** 日志流ID，获取方式请参见：[获取日志组ID和日志流ID](https://support.huaweicloud.com/api-lts/lts_api_0014.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | search_type | 否 | String | **参数解释：** 快速查询类型。 **约束限制：** 不涉及。 **取值范围：** - ORIGINALLOG：原始日志。 - VISUALIZATION：可视化日志。 **默认取值：** 不涉及。 | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 从IAM服务获取的用户Token，获取方式请参见：[获取用户Token](https://support.huaweicloud.com/api-lts/lts_api_0004.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | Content-Type | 是 | String | **参数解释：** 用于定义消息体的格式，该字段填为：application/json;charset=utf8。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | search_criterias | Array of [GetQuerySearchCriteriasBody] objects | **参数解释：** 快速查询的详细信息。 | 表5GetQuerySearchCriteriasBody | 参数 | 参数类型 | 描述 | |:---|:---|:---| | criteria | String | **参数解释：** 快速查询的内容，一般为可视化的SQL语句或关键词查询语句。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 快速查询名称。 **取值范围：** 不涉及。 | | id | String | **参数解释：** 快速查询ID。 **取值范围：** 不涉及。 | | search_type | String | **参数解释：** 快速查询的内容，一般为可视化的sql语句或关键词查询语句。 **取值范围：** - ORIGINALLOG：日志搜索。 - VISUALIZATION：日志分析。 - SEARCHANALYSIS：统计图表。 | **状态码：400** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | message | [ErrorMessagebody] object | **参数解释：** 错误信息详情。 | 表7ErrorMessagebody | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释：** 错误码，请参见：[错误码](https://support.huaweicloud.com/api-lts/ErrorCode.html)。 **取值范围：** 不涉及。 | | details | String | **参数解释：** 调用失败响应信息描述。 **取值范围：** 不涉及。 | **状态码：500** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | message | [ErrorMessagebody] object | **参数解释：** 错误信息详情。 | 表9ErrorMessagebody | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释：** 错误码，请参见：[错误码](https://support.huaweicloud.com/api-lts/ErrorCode.html)。 **取值范围：** 不涉及。 | | details | String | **参数解释：** 调用失败响应信息描述。 **取值范围：** 不涉及。 | #### 请求示例 获取快速查询。 ``` /v1.0/2a473356cca5487f8373be891bffc1cf/groups/d1f4240d-5ee2-4e0b-9e2c-e25c7978c001/topics/2b899d46-218c-4f0c-8ace-a36a290a83a0/search-criterias?search_type=ORIGINALLOG search_type: ORIGINALLOG ``` #### 响应示例 **状态码：200** 获取快速查询成功。 ``` { "search_criterias" : [ { "criteria" : "content : 1234567891234567891234567891234567891234567891234567891234567894", "name" : "创建数字", "id" : "0eb379f5-f847-4d25-ba89-05967bf1bae3", "search_type" : "ORIGINALLOG" } ] } ``` **状态码：400** 非法请求，建议根据error_msg直接修改该请求。 ``` { "message" : { "code" : "LTS.0208", "details" : "The log stream does not existed" } } ``` **状态码：500** 表明服务端能被请求访问到，但是服务内部出错。 ``` { "message" : { "code" : "LTS.0203", "details" : "Internal Server Error" } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 获取快速查询成功。 | | 400 | 非法请求，建议根据error_msg直接修改该请求。 | | 500 | 表明服务端能被请求访问到，但是服务内部出错。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-lts/ErrorCode.html)。