调用DescribeAuditLogRecords接口查询AnalyticDB MySQL版集群的SQL审计日志。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeAuditLogRecords

系统规定参数。取值：DescribeAuditLogRecords。

DBClusterId String 是 am-****************

集群ID。

说明 您可以调用DescribeDBClusters接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。
RegionId String 是 cn-hangzhou

地域ID。

说明 您可以调用DescribeRegions接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。
StartTime String 是 2021-06-08T09:53Z

查询开始时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。

EndTime String 是 2021-06-08T09:54Z

查询结束时间，结束时间需晚于查询开始时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。

DBName String 否 adb_demo

执行SQL的数据库名称。
QueryKeyword String 否 adb

对查询包含目标关键字的SQL进行查询。
SqlType String 否 SELECT

SQL类型，取值范围如下：

  • DELETE
  • SELECT
  • UPDATE
  • INSERT_INTO_SELECT
说明 每次仅允许传入一种类型查询，若该参数留空，默认查询SELECT类型。
Succeed String 否 true

目标SQL是否执行成功，取值范围如下：

  • true：成功。
  • false：失败。
HostAddress String 否 100.104.***.***:7072

执行目标SQL的客户端IP地址和端口号，格式为：IP地址:端口号。

OrderType String 否 asc

按SQL执行时间进行正序或倒序排序，取值范围如下：

  • asc：正序。
  • desc：倒序。
User String 否 test_user

执行目标SQL的用户名。
PageSize Integer 否 10

每页记录数，取值为10（默认值）、30、50或100。

PageNumber Integer 否 1

页码，取值为大于0且不超过Integer数据类型的最大值。默认值为1。

返回数据

名称 类型 示例值 描述
TotalCount String 1

总记录数。
PageSize String 10

本页记录数。
RequestId String 8A564B7F-8C00-43C0-8EC5-919FBB******

请求ID。
PageNumber String 1

页数。
DBClusterId String am-****************

集群ID。
Items Array of SlowLogRecord

SQL审计日志详情。
HostAddress String 100.104.***.***:7072

执行目标SQL的客户端IP地址和端口号
Succeed String true

目标SQL是否执行成功
SQLText String SELECT * FROM tb_courses

SQL语句详情。
TotalTime String 216

目标SQL的执行时长，单位：毫秒（ms）。
ConnId String 61918

通信ID。
DBName String adb_test

执行目标SQL的数据库名称。
SQLType String SELECT

目标SQL的类型。
ExecuteTime String 2021-06-08 17:52:02.163

目标SQL的执行开始时间，格式为yyyy-MM-ddTHH:mm:ss.SSSZ（UTC时间）。

ProcessID String 2021060817520217201616624903453******

任务ID。

示例

请求示例

http(s)://adb.aliyuncs.com/?Action=DescribeAuditLogRecords
&DBClusterId=am-****************
&RegionId=cn-hangzhou
&StartTime=2021-06-08T09:53Z
&EndTime=2021-06-08T09:54Z
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeAuditLogRecordsResponse>
    <TotalCount>1</TotalCount>
    <RequestId>8A564B7F-8C00-43C0-8EC5-919FBB******</RequestId>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <DBClusterId>am-****************</DBClusterId>
    <Items>
        <ConnId>61918</ConnId>
        <ExecuteTime>2021-06-08 17:52:02.163</ExecuteTime>
        <TotalTime>216</TotalTime>
        <DBName>adb_test</DBName>
        <ProcessID>2021060817520217201616624903453******</ProcessID>
        <HostAddress>100.104.***.***:7072</HostAddress>
        <SQLType>SELECT</SQLType>
        <SQLText>SELECT * FROM tb_courses</SQLText>
        <Succeed>true</Succeed>
    </Items>
</DescribeAuditLogRecordsResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "RequestId" : "8A564B7F-8C00-43C0-8EC5-919FBB******",
  "PageSize" : 10,
  "PageNumber" : 1,
  "DBClusterId" : "am-****************",
  "Items" : [ {
    "ConnId" : "61918",
    "ExecuteTime" : "2021-06-08 17:52:02.163",
    "TotalTime" : "216",
    "DBName" : "adb_test",
    "ProcessID" : "2021060817520217201616624903453******",
    "HostAddress" : "100.104.***.***:7072",
    "SQLType" : "SELECT",
    "SQLText" : "SELECT * FROM tb_courses",
    "Succeed" : "true"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records. 您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。

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