全部产品
Search
文档中心

数据管理 DMS:GetOpLog - 获取指定时间内的操作日志详情列表

更新时间:Nov 06, 2024

获取指定时间内的操作日志详情列表。

接口说明

仅用户角色为管理员、DBA 或安全管理员,可调用 ListUsersGetUser 接口获取用户角色(RoleIdList)。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
dms:GetOpLogget
  • 全部资源
    *

请求参数

名称类型必填描述示例值
Tidlong

租户 ID,可通过调用接口 GetUserActiveTenantListUserTenants 获取该参数的值。

3***
Modulestring

功能模块,缺省则返回对应时间段内所有功能模块,取值如下:

  • PERMISSION:权限
  • OWNER:数据 Owner
  • SQL_CONSOLE:SQL 窗口
  • SQL_CONSOLE_EXPORT:SQL 窗口结果导出
  • DATA_CHANGE:数据变更
  • DATA_EXPORT:数据导出
  • SQL_REVIEW:SQL 审核
  • DT_SYNC:库表同步
  • DT_DETAIL:库表详情
  • DB_TASK:任务管理
  • INSTANCE_MANAGE:实例管理
  • USER_MANAGE:用户管理
  • SECURITY_RULE:安全规则
  • CONFIG_MANAGE:配置管理
  • RESOURCE_AUTH:资源授权
  • ACCESS_WHITE_IP:访问 IP 白名单
  • NDDL:结构设计
  • DSQL_CONSOLE:跨库数据查询
  • DSQL_CONSOLE_EXPORT:跨库查询结果导出
  • DATA_TRACT:数据追踪
  • DATA_QUALITY:数据质量
  • DATALINK_MANAGE:DBLink 管理
  • DATASEC_MANAGE:敏感数据管理
  • SELL:售卖
SECURITY_RULE
StartTimestring

开始时间,时间格式为 yyyy-MM-DD HH:mm:ss。

2022-03-23 10:00:00
EndTimestring

结束时间,时间格式为 yyyy-MM-DD HH:mm:ss。

2022-03-29 10:00:00
PageSizeinteger

每页记录数,取值如下:

  • 30
  • 50
  • 100
30
PageNumberinteger

页码,从 1 开始。

1
UserNickstring

用户在 DMS 上的显示名。

test_name
DatabaseNamestring

数据库名称。

dmstest@rm-bp1qb97d4b****.mysql.rds.aliyuncs.com:3306【poc_dev】

返回参数

名称类型描述示例值
object
TotalCountlong

操作日志总条数。

1
RequestIdstring

请求 ID。

47D56208-DB1D-4FD3-BE32-300E43185488
ErrorCodestring

错误码。

403
OpLogDetailsarray<object>

操作日志详情列表。

OpLogDetailobject

操作日志详情。

Modulestring

功能模块。

安全规则
Databasestring

数据库访问地址。

说明
  • 仅实例类型为 LocalInstance 时有这个属性。
  • 仅任务类型区域的各功能模块操作有这个属性。
  • dmstest@rm-bp1qb97d4b****.mysql.rds.aliyuncs.com:3306【poc_dev】
    UserIdstring

    用户 UID。

    22275482072787****
    OpUserIdlong

    操作人员的用户 ID。

    51****
    OpContentstring

    操作内容。

    SELECT * FROM `orders` \n LIMIT 20
    UserNickstring

    用户显示名。

    test_name
    OrderIdlong

    工单号或任务号。

    说明 仅任务类型区域的各功能模块操作与系统管理任务管理功能模块的操作才有这个属性。
    509****
    OpTimestring

    操作时间。

    2022-03-28 16:45:19
    ErrorMessagestring

    错误消息。

    UnknownError
    Successboolean

    请求是否成功,返回值如下:

    • true:请求成功
    • false:请求失败
    true

    示例

    正常返回示例

    JSON格式

    {
      "TotalCount": 1,
      "RequestId": "47D56208-DB1D-4FD3-BE32-300E43185488",
      "ErrorCode": "403",
      "OpLogDetails": {
        "OpLogDetail": [
          {
            "Module": "安全规则",
            "Database": "dmstest@rm-bp1qb97d4b****.mysql.rds.aliyuncs.com:3306【poc_dev】",
            "UserId": "22275482072787****",
            "OpUserId": 0,
            "OpContent": "SELECT * FROM `orders` \\n LIMIT 20",
            "UserNick": "test_name",
            "OrderId": 0,
            "OpTime": "2022-03-28 16:45:19"
          }
        ]
      },
      "ErrorMessage": "UnknownError",
      "Success": true
    }

    错误码

    访问错误中心查看更多错误码。

    变更历史

    变更时间变更内容概要操作
    2023-04-27OpenAPI 入参发生变更查看变更详情
    2023-04-27OpenAPI 入参发生变更查看变更详情

    SDK 示例

    SDK 使用基础信息参考:阿里云 Python SDK

    示例如下:

    from aliyunsdkcore.client import AcsClient
    from aliyunsdkdms_enterprise.request.v20181101.GetOpLogRequest import GetOpLogRequest
    client = AcsClient(
        "<your-access-key-id>",
       "<your-access-key-secret>",
       "<your-region-id>"
    )
    request = GetOpLogRequest()
    request.set_Tid("请输入你的企业租户 id")
    request.set_StartTime("2018-11-20 00:00:00")
    request.set_EndTime("2018-11-23 00:00:00")
    request.set_PageNumber(1)
    request.set_PageSize(50)
    response = client.do_action_with_exception(request)
    print response