通过LTS查询错误日志 - ListErrorlogForLts

功能介绍

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

调用接口前，您需要了解API认证鉴权。
调用接口前，您需要了解请求Header参数说明。

调试

您可以在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" 
  } ] 
}