更新时间：2026-03-11 GMT+08:00
查询扩展日志（SQL Server） - ListXellogFiles
调试
您可以在API Explorer中调试该接口。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
|
授权项 |
访问级别 |
资源类型（*为必须） |
条件键 |
别名 |
依赖的授权项 |
|---|---|---|---|---|---|
|
rds:log:getErrorLogs |
list |
instance |
- g:EnterpriseProjectId - g:ResourceTag/<tag-key> |
- |
- |
接口约束
该接口仅支持SQL Server数据库引擎。
URI
- 参数说明
表1 参数说明 名称
是否必选
说明
project_id
是
参数解释：
租户在某一region下的project ID。
约束限制：
非空。
取值范围：
获取方法请参见获取项目ID。
默认取值：
不涉及。
instance_id
是
参数解释：
实例ID。
约束限制：
非空。
取值范围：
该参数值可调用查询数据库实例列表接口，通过表4中的“id”获取。
默认取值：
不涉及。
offset
否
参数解释：
索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。
约束限制：
不涉及。
取值范围：
必须为数字，不能为负数。
默认取值：
默认为0（偏移0条数据，表示从第一条数据开始查询）。
limit
否
参数解释：
每页多少条记录（查询结果）。
约束限制：
不涉及。
取值范围：
取整数1~100。
默认取值：
不填时默认为10。
请求消息
响应消息
- 正常响应要素说明
表2 要素说明 名称
参数类型
说明
list
Array of objects
参数解释：
扩展日志文件信息。详情请参见表3。
count
Integer
参数解释：
文件总数。
取值范围：
不涉及。
- 正常响应样例
{ "list" : [ { "file_name" : "SQLTrace.xel", "file_size" : "1024" }, { "file_name" : "SQLTrace2.xel", "file_size" : "1024" } ], "count" : 2 } - 异常响应
请参见异常请求结果。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。
父主题： 获取日志信息
