调用DescribeBackupLogs接口查询备份日志列表、获取备份日志下载地址。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeBackupLogs |
系统规定参数。取值:DescribeBackupLogs。 |
DBClusterId | String | 是 | pc-************** |
集群ID。 |
StartTime | String | 是 | 2020-02-01T15:00Z |
查询开始时间。格式为 |
EndTime | String | 是 | 2020-02-12T15:00Z |
查询结束时间,需晚于查询开始时间。格式为 |
BackupRegion | String | 否 | cn-hangzhou |
备份地域。 |
PageSize | Integer | 否 | 30 |
每页记录数,取值范围如下:
默认值为30。 |
PageNumber | Integer | 否 | 1 |
页码,取值范围为大于0且不超过Integer的最大值的整数,默认值为1。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
TotalRecordCount | String | 2 |
总记录数。 |
PageRecordCount | String | 2 |
本页记录数。 |
RequestId | String | ADAC63DB-0691-4ECE-949A-FAEA68****** |
请求ID。 |
PageNumber | String | 1 |
页码。 |
Items | Array of BackupLog |
备份日志详情。 |
|
BackupLog | |||
BackupLogId | String | 1111111111 |
备份日志ID。 |
IntranetDownloadLink | String | http://***********.oss-cn-hangzhou-internal.aliyuncs.com |
备份日志的内网下载链接。 |
LinkExpiredTime | String | 2020-02-14T08:40:50Z |
下载链接的过期时间。 |
BackupLogStartTime | String | 2020-02-12T03:54:43Z |
本次备份日志开始时间,格式为 |
BackupLogEndTime | String | 2020-02-12T03:55:31Z |
本次备份日志结束时间,格式为 |
DownloadLink | String | http://***********.oss-cn-hangzhou.aliyuncs.com |
备份日志的公网下载链接。 |
BackupLogSize | String | 1073741824 |
备份日志大小,单位为Byte。 |
BackupLogName | String | ib_logfile1 |
备份日志文件名。 |
示例
请求示例
http(s)://polardb.aliyuncs.com/?Action=DescribeBackupLogs
&DBClusterId=pc-**************
&StartTime=2020-02-01T15:00Z
&EndTime=2020-02-12T15:00Z
&BackupRegion=cn-hangzhou
&PageSize=30
&PageNumber=1
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeBackupLogsResponse>
<TotalRecordCount>2</TotalRecordCount>
<PageRecordCount>2</PageRecordCount>
<RequestId>ADAC63DB-0691-4ECE-949A-FAEA68******</RequestId>
<PageNumber>1</PageNumber>
<Items>
<BackupLog>
<DownloadLink>http://***********.oss-cn-hangzhou.aliyuncs.com</DownloadLink>
<BackupLogEndTime>2020-02-12T03:55:31Z</BackupLogEndTime>
<BackupLogId>1111111111</BackupLogId>
<BackupLogName>ib_logfile1</BackupLogName>
<LinkExpiredTime>2020-02-14T08:40:50Z</LinkExpiredTime>
<BackupLogSize>1073741824</BackupLogSize>
<IntranetDownloadLink>http://***********.oss-cn-hangzhou-internal.aliyuncs.com</IntranetDownloadLink>
<BackupLogStartTime>2020-02-12T03:54:43Z</BackupLogStartTime>
</BackupLog>
</Items>
</DescribeBackupLogsResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"TotalRecordCount" : 2,
"PageRecordCount" : 2,
"RequestId" : "ADAC63DB-0691-4ECE-949A-FAEA68******",
"PageNumber" : 1,
"Items" : {
"BackupLog" : [ {
"DownloadLink" : "http://***********.oss-cn-hangzhou.aliyuncs.com",
"BackupLogEndTime" : "2020-02-12T03:55:31Z",
"BackupLogId" : 1111111111,
"BackupLogName" : "ib_logfile1",
"LinkExpiredTime" : "2020-02-14T08:40:50Z",
"BackupLogSize" : 1073741824,
"IntranetDownloadLink" : "http://***********.oss-cn-hangzhou-internal.aliyuncs.com",
"BackupLogStartTime" : "2020-02-12T03:54:43Z"
} ]
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidStartTime.Malformed | The specified parameter StartTime is not valid. | 指定的参数StartTime无效 |
400 | InvalidEndTime.Malformed | The specified parameter EndTime is not valid. | 指定的参数EndTime无效 |
400 | InvalidPageSize.Malformed | The specified parameter PageSize is not valid. | 指定的参数PageSize无效 |
400 | InvalidPageNumber.Malformed | The specified parameter PageNumber is not valid. | 指定的参数PageNumber无效 |
404 | InvalidDBCluster.NotFound | The DBClusterId provided does not exist in our records. | 当前的记录中不存在提供的DBClusterId。 |
404 | InvalidDBClusterId.Malformed | The specified parameter DBClusterId is not valid. | 指定的参数DBClusterId无效 |
访问错误中心查看更多错误码。