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

通过LTS查询错误日志 - ListErrorlogForLts

功能介绍

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

调试

您可以在API Explorer中调试该接口。

授权信息

账号具备所有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下的project ID。

    约束限制：

    非空。

    取值范围：

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

    默认取值：

    不涉及。

    instance_id

    是

    参数解释：

    实例ID。

    约束限制：

    非空。

    取值范围：

    该参数值可调用查询数据库实例列表接口，通过表4中的“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
  • INFO
  • LOG
  • WARNING
  • ERROR
  • FATAL
  • PANIC
  • NOTE

默认取值：

ALL

line_num

否

String

参数解释：

日志单行序列号。

约束限制：

第一次查询时不需要此参数，后续分页查询时需要使用，可从上次查询的返回信息中获取。

取值范围：

line_num应在start_time和end_time之间。

默认取值：

不涉及。

search_type

否

String

参数解释：

搜索方式。配合line_num使用。

约束限制：

不涉及。

取值范围：

  • forwards：以line_num为起点，向前搜索。
  • backwards：以line_num为起点，向后搜索。

默认取值：

forwards

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

    参数解释：

    日志级别。

    取值范围：

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

    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" 
  } ] 
}
  • 异常响应

    请参见异常请求结果。

状态码

错误码

请参见错误码。

父主题： 获取日志信息

相关文档