更新时间:2024-08-09 GMT+08:00
分享

获取审计日志列表

功能介绍

获取审计日志列表。

调试

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

URI

  • URI格式

    GET /v3/{project_id}/instances/{instance_id}/auditlog?start_time={start_time}&end_time={end_time}&offset={offset}&limit={limit}

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    参数解释

    租户在某一Region下的项目ID。

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

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

    instance_id

    参数解释

    要查询的实例ID。

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

    start_time

    参数解释

    查询开始时间。

    约束限制

    不涉及。

    取值范围

    格式为“yyyy-mm-ddThh:mm:ssZ”。

    其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。

    默认取值

    不涉及。

    end_time

    参数解释

    查询结束时间。

    约束限制

    不涉及。

    取值范围

    格式为“yyyy-mm-ddThh:mm:ssZ”,且大于查询开始时间,时间跨度不超过30天。

    其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。

    默认取值

    不涉及。

    offset

    参数解释:

    索引位置,偏移量。从第一条数据偏移offset条数据后开始查询,值为0表示从第一条数据开始查询)。

    约束限制:

    必须为数字,不能为负数。

    取值范围:

    大于等于0的整数。

    默认取值:

    0

    limit

    参数解释:

    查询记录数。

    约束限制:

    不涉及。

    取值范围:

    [1, 50]

    默认取值:

    不涉及。

请求消息

  • 请求参数

    无。

  • URI样例

    GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/auditlog?start_time=2019-11-06T09:00:00+0800&end_time=2019-11-07T10:40:15+0800&offset=0&limit=10

响应消息

  • 正常响应要素说明
    表2 要素说明

    名称

    参数类型

    说明

    auditlogs

    Array of objects

    参数解释:

    具体信息。

    详情请参见表3

    total_record

    Integer

    参数解释:

    总记录数。

    取值范围

    不涉及。

    表3 auditlogs字段数据结构说明

    名称

    参数类型

    说明

    id

    String

    参数解释:

    审计日志ID。当引擎为SQL Server时,ID为审计日志文件名。

    取值范围

    不涉及。

    name

    String

    参数解释:

    审计日志文件名。

    取值范围

    不涉及。

    size

    Long

    参数解释:

    审计日志大小,单位:KB

    取值范围

    不涉及。

    begin_time

    String

    参数解释:

    审计日志开始时间。

    取值范围

    格式为“yyyy-mm-ddThh:mm:ssZ”。

    其中,T指某个时间的开始,Z指时区偏移量,例如北京时间偏移显示为+0800。

    end_time

    String

    参数解释:

    审计日志结束时间。

    取值范围

    格式为“yyyy-mm-ddThh:mm:ssZ”。

    其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。

  • 正常响应样例
    {
    	"auditlogs": [{
    		"id": "fa163ea0e2bet11e9d832166a2cf894c5br01",
    		"name": "2943db4292ee4d4abb1ae2df4870fedf_528f6b03c71c4d559ca4f60b6e20795fin01/39779175_20220825/Audit/317156_20190916032844_eb8fe5d181ec44a2850302691541f760in01_Audit_166a2cf8-d832-11e9-94c5-fa163ea0e2be",
    		"size": 20481.835938,
    		"begin_time": "2019-11-06T09:03:34+0800",
    		"end_time": "2019-11-06T10:39:15+0800"
    	}, {
    		"id": "fa163ea0e2bet11e9d832136a668094c5br01",
    		"name": "2943db4292ee4d4abb1ae2df4870fedf_528f6b03c71c4d559ca4f60b6e20795fin01/39779175_20220825/Audit/317162_20190916032838_eb8fe5d181ec44a2850302691541f760in01_Audit_136a6680-d832-11e9-94c5-fa163ea0e2be",
    		"size": 20481.835938,
    		"begin_time": "2019-11-07T09:04:35+0800",
    		"end_time":"2019-11-07T10:38:16+0800"
    	}],
    	"total_record": 2
    }
  • 异常响应

    请参见异常请求结果

状态码

错误码

请参见错误码

相关文档