文档首页/ 云数据库 RDS/ API参考/ API v3/ 实例管理/ 查询指定实例的操作记录 - ListOperateRecord
更新时间：2026-09-20 GMT+08:00
查看PDF
分享

查询指定实例的操作记录 - ListOperateRecord

功能介绍

查询指定实例的操作记录。

调试

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

授权信息

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

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

rds:task:listAll

list

-

-

rds:task:list

-

URI

  • URI格式

    POST /v3/{project_id}/instances/{instance_id}/operate-record

  • 参数说明
    表1 参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    是

    String

    参数解释：

    租户在某一region下的project ID。

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

    约束限制：

    不涉及。

    取值范围：

    不涉及。

    默认取值：

    不涉及。

    instance_id

    是

    String

    参数解释：

    实例ID。

    可调用查询数据库实例列表接口，通过表4中的“id”获取。

    约束限制：

    不涉及。

    取值范围：

    不涉及。

    默认取值：

    不涉及。

请求消息

表2 参数说明

参数

是否必选

参数类型

描述

start_time

是

Integer

参数解释：

查询开始时间，格式为毫秒级时间戳。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

end_time

是

Integer

参数解释：

查询结束时间，格式为毫秒级时间戳。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

operate_type

否

String

参数解释：

操作类型。

约束限制：

不涉及。

取值范围：

  • resetPassword
  • instanceRestore
  • instanceRestart
  • updateParameterGroup
  • backupsDownLoad

默认取值：

不涉及。

user_name

否

String

参数解释：

用户名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

level

否

String

参数解释：

事件等级。

约束限制：

不涉及。

取值范围：

  • normal：操作成功。
  • warning：操作失败。
  • incident：比操作失败更严重的情况，如引起其他故障等。

默认取值：

不涉及。

offset

否

String

参数解释：

查询偏移量。

约束限制：

不涉及。

取值范围：

大于等于0的整数。

默认取值：

0

limit

否

String

参数解释：

查询条数。

约束限制：

不涉及。

取值范围：

1~100

默认取值：

10

sort

否

String

参数解释：

排序字段。

约束限制：

不涉及。

取值范围：

  • operate_type：操作类型。
  • user_name：用户名称。
  • operate_time：操作时间。
  • level：事件等级。

默认取值：

operate_time

order

否

String

参数解释：

排序方式。

约束限制：

不涉及。

取值范围：

  • desc：倒序。
  • asc：正序。

默认取值：

desc

请求示例

查询指定实例的操作记录。

POST https://{Endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/e28979107ed04d3b8b2f1b819b8d2be3in03/operate-record

{
  "start_time": 1787643916104,
  "end_time": 1788935503878,
  "operate_type": "resetPassword",
  "user_name": "rds_test",
  "level": "warning",
  "offset": "0",
  "limit": "10",
  "sort": "operate_time",
  "order": "DESC"
}

响应消息

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

    参数

    参数类型

    描述

    count

    Integer

    参数解释：

    本次查询事件列表返回的事件记录的总条数。

    取值范围：

    不涉及。

    traces

    Array of objects

    参数解释：

    本次查询事件列表返回的事件记录。详情请参见表4。

    all_operate_type

    Array of String

    参数解释：

    所有事件类型。

    取值范围：

    • resetPassword
    • instanceRestore
    • instanceRestart
    • updateParameterGroup
    • backupsDownLoad
    表4 traces字段说明

    参数

    参数类型

    描述

    operate_type

    String

    参数解释：

    操作类型。

    取值范围：

    • resetPassword
    • instanceRestore
    • instanceRestart
    • updateParameterGroup
    • backupsDownLoad

    user_name

    String

    参数解释：

    用户名称。

    取值范围：

    不涉及。

    operate_time

    Integer

    参数解释：

    操作时间。

    取值范围：

    不涉及。

    level

    String

    参数解释：

    事件等级。

    取值范围：

    • normal：操作成功。
    • warning：操作失败。
    • incident：比操作失败更严重的情况，如引起其他故障等。
  • 正常响应样例 
    {
  "count": 1,
  "traces": [
    {
      "operate_type": "resetPassword",
      "user_name": "rds_test",
      "operate_time": 1787643916104,
      "level": "warning"
    }
  ],
  "all_operate_type": [
    "resetPassword",
    "instanceRestore",
    "instanceRestart",
    "updateParameterGroup",
    "backupsDownLoad"
  ]
}

状态码

错误码

请参见错误码。

父主题： 实例管理

相关文档