Skip to Content
云数据库 UDB MySQL列表UDB实例日志备份信息 - DescribeUDBLogPackage

列表UDB实例日志备份信息 - DescribeUDBLogPackage

简介

列表UDB实例binlog或slowlog或errorlog备份信息

💡 不支持新版(NVMe型)MongoDB/PostgreSQL, 新版(NVMe型)MongoDB/PostgreSQL请使用对应产品的API

定义

公共参数

参数名类型描述信息必填
Actionstring对应的 API 指令名称,当前 API 为 DescribeUDBLogPackageYes
PublicKeystring用户公钥,可从 控制台 获取Yes
Signaturestring根据公钥及 API 指令生成的用户签名,参见 签名算法Yes

请求参数

参数名类型描述信息必填
Regionstring地域。 参见 地域和可用区列表Yes
Zonestring可用区。参见 可用区列表No
ProjectIdstring项目ID。不填写为默认项目,子帐号必须填写。 请参考GetProjectList接口No
Offsetint分页显示的起始偏移,列表操作则指定Yes
Limitint分页显示的条目数,列表操作则指定Yes
Typeint需要列出的备份文件类型,每种类型的值如下: 2 代表 BINLOG_BACKUP; 3 代表 SLOW_QUERY_BACKUP; 4 代表 ERRORLOG_BACKUP;No
Types.NintTypes作为Type的补充,支持多值传入,可以获取多个类型的日志记录,如:Types.0=2&Types.1=3No
DBIdstringDB实例Id,如果指定,则只获取该db的备份信息; 当Type为2时必填No
BeginTimeint过滤条件:起始时间(时间戳)No
EndTimeint过滤条件:结束时间(时间戳)No

响应字段

字段名类型描述信息必填
RetCodeint返回状态码,为 0 则为成功返回,非 0 为失败Yes
Actionstring操作指令名称Yes
Messagestring返回错误消息,当 RetCode 非 0 时提供详细的描述信息No
DataSetarray[LogPackageDataSet]备份信息 参见LogPackageDataSetNo
TotalCountint备份总数,如果指定dbid,则是该db备份总数No

数据模型

LogPackageDataSet

字段名类型描述信息必填
Zonestring所在可用区No
BackupIdint备份idNo
BackupNamestring备份名称No
BackupTimeint备份时间No
BackupSizeint备份文件大小No
BackupTypeint备份类型,包括2-binlog备份,3-slowlog备份No
BinlogTypestringbinlog备份类型 Manual //手动备份 Auto //自动备份No
Statestring备份状态 Backuping // 备份中 Success // 备份成功 Failed // 备份失败 Expired // 备份过期No
DBIdstringdbidNo
DBNamestring对应的db名称No
BackupZonestring跨可用区高可用备库所在可用区No

示例

请求示例

https://api.an-link.com/?Action=DescribeUDBLogPackage &Region=cn-bj2 &Zone=cn-bj2-04 &Offset=0 &Limit=20 &Type=2

响应示例

{ "Action": "DescribeUDBLogPackageResponse", "DataSet": [ { "BackupId": 45264, "BackupName": "undefined", "BackupSize": 339, "BackupTime": 1329815192, "BackupType": 2, "BackupZone": "", "DBId": "udbha-xxxxxx", "DBName": "test_linshi", "State": "Success", "Zone": "cn-bj2-04" }, { "BackupId": 39, "BackupName": "rizhi_01", "BackupSize": 10670, "BackupTime": 1439430490, "BackupType": 2, "BackupZone": "", "DBId": "udb-xxxxxx", "DBName": "annian_2g", "State": "Success", "Zone": "cn-bj2-05" } ], "RetCode": 0, "TotalCount": 2 }