获取日志列表

最近更新时间: 2026-09-17 00:05:09

1. 接口描述

接口请求域名： dcdb.api3.fincloud.tencent.cn。

本接口(DescribeDBLogFiles)用于获取数据库的各种日志列表，包括冷备、binlog、errlog和slowlog。

默认接口请求频率限制：20次/秒。

接口更新时间：2019-03-30 12:41:29。

接口只验签名不鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：DescribeDBLogFiles
Version 是 否 String 公共参数，本接口取值：2018-04-11
Region 是 否 String 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
InstanceId 是 否 String 实例Id，形如：tdsql-ow728lmc。
示例值： tdsqlshard-cq3ndzu7
ShardId 是 否 String 分片 ID，形如：shard-7noic7tv
示例值： shard-gdqcdn39
Type 是 否 Int64 请求日志类型，取值只能为1、2、3或者4。1-binlog，2-冷备，3-errlog，4-slowlog。
示例值： 1

3. 输出参数

参数名称 类型 描述
InstanceId String 实例 ID，形如：dcdbt-ow728lmc。
示例值： tdsqlshard-cq3ndzu7
Type Uint64 请求日志类型。1-binlog，2-冷备，3-errlog，4-slowlog。
示例值： 1
Total Uint64 请求日志总数
示例值： 1
Files Array of LogFileInfo 日志文件列表
示例值：查看
VpcPrefix String 如果是VPC网络的实例，做用本前缀加上URI为下载地址
示例值： http://169.254.0.27:8083
NormalPrefix String 如果是普通网络的实例，做用本前缀加上URI为下载地址
示例值： http://10.66.255.253:8083
ShardId String 分片 ID，形如：shard-7noic7tv
示例值： shard-gdqcdn39
RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码 描述
InternalError.CamAuthFailed CAM鉴权请求失败。
InternalError.CosConfiguration COS地址配置错误。
InternalError.CosSignUrl 备份文件签名失败。
InternalError.DbOperationFailed 查询数据库失败。
InternalError.GetInstanceInfoFailed 获取实例信息失败。
InvalidParameter.GenericParameterError 参数合法性校验错误。
InvalidParameter.InstanceNotFound 未找到请求的实例。
ResourceNotFound.NoInstanceFound 找不到指定的数据库实例。
ResourceUnavailable.CosApiFailed COS API调用错误。
ResourceUnavailable.InstanceAlreadyDeleted 数据库实例已被删除。
ResourceUnavailable.InstanceStatusAbnormal 数据库实例状态不正确，当前无法操作。
UnauthorizedOperation.PermissionDenied 没有权限操作该接口或资源。

5. 示例

示例1 获取日志列表

输入示例

https://dcdb.api3.fincloud.tencent.cn/?Action=DescribeDBLogFiles
&InstanceId=dcdbt-2t4cf98d
&ShardId=shard-gdqcdn39
&Type=1
&<公共请求参数>

输出示例

{
  "Response": {
    "Files": [
      {
        "Length": 5253724,
        "Mtime": 1468822981,
        "Uri": "/1/noshard_108/group_1520844319_37793941/1468578832/859932065/000001/5ce7d1a8f26c2dfcf1de22d4e9792b11b0b0057450684d266e1bf9a8aa6ea272/1/shard-5ps4rppj/set_1516333432_6"
      }
    ],
    "InstanceId": "dcdbt-2t4cf98d",
    "ShardId": "shard-gdqcdn39",
    "NormalPrefix": "http://10.66.255.253:8083",
    "RequestId": "7212a9ec-a235-2144-98d4-59fbe6f14d79",
    "Total": 1,
    "Type": 1,
    "VpcPrefix": "http://169.254.0.27:8083"
  }
}