GetProjectLogs

接口说明

• 该接口的query是一个标准的SQL查询语句。
• 查询的Project在请求的域名中指定。
• 查询的Logstore在查询语句的from条件中指定。可以将Logstore看做是SQL中的表。
• 在查询的SQL条件中必须指定要查询的时间范围，时间范围由__date__（timestamp类型）或__time__（int类型，单位是unix_time）来指定。
• 当查询涉及的日志数量变化非常大时，日志服务API无法预测需要调用多少次该接口来获取完整结果。所以需要您查看每次请求返回结果中的x-log-progress成员状态值，根据成员状态值来确定是否需要重复调用该接口来获取最终完整结果。需要注意的是，每次重复调用该接口都会重新消耗相同数量的查询CU。

请求语法

GET /logs query=SELECT avg(latency) as avg_latency FROM  where __date__ >'2017-09-01 00:00:00' and __date__ < '2017-09-02 00:00:00'
Authorization: <AuthorizationString>
Date: Wed, 3 Sept. 2014 08:33:46 GMT
Host: big-game.cn-hangzhou.log.aliyuncs.com
x-log-bodyrawsize: 0
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1

请求参数

• 请求头

  GetProjectLogs接口无特有请求头。关于Log Service API的公共请求头，请参见公共请求头。

• 参数列表

  属性名称	类型	是否必须	示例值	描述
  query	string	是	SELECT * FROM <logStoreName> where __line__ = 'abc' and __date__ >'2017-09-01 00:00:00' and __date__ < '2017-09-02 00:00:00'&line=20&offset=0 HTTP/1.1	SQL语句。

返回数据

• 响应头
  关于Log Service API的公共响应头，请参见公共响应头。该接口特有的响应头如下表所示。

  名称	类型	描述
  x-log-progress	字符串	查询结果的状态。可以有Incomplete和Complete两个选值，表示本次是否完整。
  x-log-count	整型	当前查询结果的日志总数。
  x-log-processed-rows	整型	本次查询处理的行数。
  x-log-elapsed-millisecond	整型	本次查询消耗的毫秒时间。

• 响应元素
  GetProjectLogs的响应body是一个数组，数组中每个元素是一条日志结果。

  名称	类型	描述
  __time__	整型	日志的时间戳，精度为秒，从1970-1-1 00:00:00 UTC开始计算的秒数。
  __source__	字符串	日志的来源，写入日志时指定。
  [content]	Key-Value对	日志原始内容。

示例

错误码

更多错误码，请参见通用错误码。