调用DescribeBackupLogs接口查询备份日志列表、获取备份日志下载地址。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeBackupLogs

系统规定参数,取值:DescribeBackupLogs

DBClusterId String pc-bpxxxxxxx

集群ID。

EndTime String 2020-02-12T15:00Z

查询结束时间,需晚于查询开始时间。格式:YYYY-MM-DDThh:mmZ(UTC时间)。

StartTime String 2020-02-01T15:00Z

查询开始时间。格式 YYYY-MM-DDThh:mmZ(UTC时间)。

PageSize Integer 30

每页记录数,取值:

  • 30
  • 50
  • 100

默认值:30。

PageNumber Integer 1

页码,大于0且不超过Integer的最大值。

默认值:1。

返回数据

名称 类型 示例值 描述
RequestId String ADAC63DB-0691-4ECE-949A-FAEA686A1402

请求ID。

TotalRecordCount String 2

总记录数。

PageNumber String 1

页码。

PageRecordCount String 2

本页记录数。

Items Array

由备份日志组成的数组。

BackupLogId String 1111111111

备份日志ID。

BackupLogName String ib_logfile1

备份日志文件名。

BackupLogStartTime String 2020-02-12T03:54:43Z

本次备份日志开始时间,格式:YYYY-MM-DD'T'HH:mm:ssZ(UTC时间)。

BackupLogEndTime String 2020-02-12T03:55:31Z

本次备份日志结束时间,格式:YYYY-MM-DD'T'HH:mm:ssZ(UTC时间)。

BackupLogSize String 1073741824

备份日志大小,单位:Byte。

DownloadLink String http://xxxxxxxxxxx.oss-cn-hangzhou.aliyuncs.com

备份日志外网下载链接。

IntranetDownloadLink String http://xxxxxxxxxxx.oss-cn-hangzhou-internal.aliyuncs.com

备份日志内网下载链接。

LinkExpiredTime String 2020-02-14T08:40:50Z

下载链接过期时间。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeBackupLogs
&DBClusterId=pc-bpxxxxxxx
&EndTime=2020-02-12T15:00Z
&StartTime=2020-02-01T15:00Z
&<公共请求参数>

正常返回示例

XML 格式

<TotalRecordCount>2</TotalRecordCount>
<PageRecordCount>2</PageRecordCount>
<RequestId>ADAC63DB-0691-4ECE-949A-FAEA686A1402</RequestId>
<PageNumber>1</PageNumber>
<Items>
    <BackupLog>
        <DownloadLink>http://xxxxxxxxxxx.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://xxxxxxxxxxx.oss-cn-hangzhou-internal.aliyuncs.com</IntranetDownloadLink>
        <BackupLogStartTime>2020-02-12T03:54:43Z</BackupLogStartTime>
    </BackupLog>
    <BackupLog>
        <DownloadLink>http://xxxxxxxxxxx.oss-cn-hangzhou.aliyuncs.com</DownloadLink>
        <BackupLogEndTime>2020-02-12T03:54:45Z</BackupLogEndTime>
        <BackupLogId>2222222222</BackupLogId>
        <BackupLogName>ib_logfile2</BackupLogName>
        <LinkExpiredTime>2020-02-14T08:40:50Z</LinkExpiredTime>
        <BackupLogSize>1073741824</BackupLogSize>
        <IntranetDownloadLink>http://xxxxxxxxxxx.oss-cn-hangzhou-internal.aliyuncs.com</IntranetDownloadLink>
        <BackupLogStartTime>2020-02-12T03:53:55Z</BackupLogStartTime>
    </BackupLog>
</Items>

JSON 格式

{
  "TotalRecordCount": 2,
  "PageRecordCount": 2,
  "RequestId": "ADAC63DB-0691-4ECE-949A-FAEA686A1402",
  "PageNumber": 1,
  "Items": {
    "BackupLog": [
      {
        "DownloadLink": "http://xxxxxxxxxxx.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://xxxxxxxxxxx.oss-cn-hangzhou-internal.aliyuncs.com",
        "BackupLogStartTime": "2020-02-12T03:54:43Z"
      },
      {
        "DownloadLink": "http://xxxxxxxxxxx.oss-cn-hangzhou.aliyuncs.com",
        "BackupLogEndTime": "2020-02-12T03:54:45Z",
        "BackupLogId": 2222222222,
        "BackupLogName": "ib_logfile2",
        "LinkExpiredTime": "2020-02-14T08:40:50Z",
        "BackupLogSize": 1073741824,
        "IntranetDownloadLink": "http://xxxxxxxxxxx.oss-cn-hangzhou-internal.aliyuncs.com",
        "BackupLogStartTime": "2020-02-12T03:53:55Z"
      }
    ]
  }
}

错误码

访问错误中心查看更多错误码。