查询扩展日志（SQL Server）

功能介绍

查询扩展日志文件列表。

• 调用接口前，您需要了解API 认证鉴权。

调试

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

接口约束

该接口仅支持SQL Server数据库引擎。

URI

• URI格式

  GET /v3/{project_id}/instances/{instance_id}/xellog-files

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	租户在某一Region下的项目ID。 获取方法请参见获取项目ID。
  instance_id	是	查询的实例ID。
  offset	否	索引位置，偏移量。 从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。
  limit	否	每页多少条记录，取值范围是1~100，不填时默认为10。

请求消息

• 请求参数

  无。

• URI样例

  GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/xellog-files

响应消息

• 正常响应要素说明

  表2 要素说明

  名称	参数类型	说明
  list	Array of objects	扩展日志文件信息。详情请参见表3。
  count	Integer	文件总数。

  表3 SlowLogFile字段数据结构说明

  参数	参数类型	描述
  file_name	String	文件名。
  file_size	String	文件大小（单位：KB）。

• 正常响应样例

  { 
    "list" : [ { 
      "file_name" : "SQLTrace.xel", 
      "file_size" : "1024" 
    }, { 
      "file_name" : "SQLTrace2.xel", 
      "file_size" : "1024" 
    } ], 
    "count" : 2 
  }

• 异常响应

  请参见异常请求结果。

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。