文档首页/ 云数据库 RDS/ API参考/ API v3（推荐）/ 获取日志信息/ 通过LTS查询错误日志 - ListErrorlogForLts
更新时间：2025-12-09 GMT+08:00
查看PDF
分享

通过LTS查询错误日志 - ListErrorlogForLts

功能介绍

在确认当前区域支持LTS的情况下，支持通过该接口查询实例的错误日志数据。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

rds:log:getErrorLogs

read

-

-

rds:log:list

-

URI

  • URI格式

    POST /v3/{project_id}/instances/{instance_id}/error-logs

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    是

    租户在某一Region下的项目ID。

    获取方法请参见获取项目ID。

    instance_id

    是

    要查询的实例ID。

请求消息

表2 参数说明

名称

是否必选

参数类型

说明

start_time

是

String

开始日期，格式为“yyyy-mm-ddThh:mm:ssZ”。

其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。开始时间不能早于当前时间一个月之前。

end_time

是

String

结束时间，格式为“yyyy-mm-ddThh:mm:ssZ”。

其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。只能查询当前时间前一个月内的错误日志。

level

否

String

日志级别，默认为ALL。

枚举值：

  • ALL
  • INFO
  • LOG
  • WARNING
  • ERROR
  • FATAL
  • PANIC
  • NOTE

line_num

否

String

日志单行序列号，第一次查询时不需要此参数，后续分页查询时需要使用，可从上次查询的返回信息中获取。line_num应在start_time和end_time之间。

search_type

否

String

搜索方式。默认forwards。配合line_num使用，以line_num为起点，向前搜索或向后搜索。

limit

否

Integer

每页多少条记录（查询结果），取值范围是1~100，不填时默认为10。

请求示例

查询错误日志，每页10条记录。 
POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/error-logs
{
    "start_time":"2023-01-05T08:00:00+0800",
    "end_time":"2023-01-11T20:00:00+0800",
    "limit":10,
    "line_num":"1672908793000000000",
    "search_type":"forwards"
}

响应消息

  • 正常响应要素说明
    表3 要素说明

    名称

    参数类型

    说明

    error_log_list

    Array of objects

    日志数据集合。

    详情请参见表4。
    表4 error_log_list字段数据结构说明

    名称

    参数类型

    说明

    time

    String

    日期时间，UTC时间。

    level

    String

    日志级别。

    content

    String

    错误日志内容。

    line_num

    String

    日志单行序列号。
  • 正常响应样例 
    {
  "error_log_list" : [ { 
    "time" : "2022-08-23T22:59:17Z", 
    "level" : "WARNING", 
    "content" : "Occur error when reading bytes from a network handler. Client actively closes the connection.", 
    "line_num" : "1595659490239433658" 
  } ] 
}
  • 异常响应

    请参见异常请求结果。

状态码

错误码

请参见错误码。

父主题： 获取日志信息