You can call this operation to query backup logs and the URLs for downloading backup logs.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | No | DescribeBackupLogs |
The operation that you want to perform. Set the value to DescribeBackupLogs. |
DBClusterId | String | Yes | pc-************** |
The ID of the cluster. |
EndTime | String | Yes | 2020-02-12T15:00Z |
The end of the time range to query. The end time must be later than the start time.
Specify the time in the |
StartTime | String | Yes | 2020-02-01T15:00Z |
The beginning of the time range to query. Specify the time in the |
PageSize | Integer | No | 30 |
The number of entries to return on each page. Valid values:
Default value: 30 |
PageNumber | Integer | No | 1 |
The number of the page to return. The value must be an integer that is larger than 0. Default value: 1. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
TotalRecordCount | String | 2 |
The total number of entries returned. |
RequestId | String | ADAC63DB-0691-4ECE-949A-FAEA68****** |
The ID of the request. |
PageNumber | String | 1 |
The page number of the page returned. |
Items | Array of BackupLog |
The details of the backup log. |
|
BackupLog | |||
BackupLogEndTime | String | 2020-02-12T03:55:31Z |
The time when the backup log ended. The time follows the ISO 8601 standard in the |
BackupLogId | String | 1111111111 |
The ID of the backup log. |
BackupLogName | String | ib_logfile1 |
The name of the backup log. |
BackupLogSize | String | 1073741824 |
The size of the backup log. Unit: bytes. |
BackupLogStartTime | String | 2020-02-12T03:54:43Z |
The time when the backup task started. The time follows the ISO 8601 standard in the
|
DownloadLink | String | http://***********.oss-cn-hangzhou.aliyuncs.com |
The public URL to download the backup log. |
IntranetDownloadLink | String | http://***********.oss-cn-hangzhou-internal.aliyuncs.com |
The internal URL to download the backup log. |
LinkExpiredTime | String | 2020-02-14T08:40:50Z |
The time when the download URL expires. |
PageRecordCount | String | 2 |
The number of entries returned per page. |
Examples
Sample request
http(s)://polardb.aliyuncs.com/? Action=DescribeBackupLogs
&DBClusterId=pc-**************
&EndTime=2020-02-12T15:00Z
&StartTime=2020-02-01T15:00Z
&<Common request parameters>
Sample success responses
XML
format
<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
format
{
"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"
}
]
}
}
Error codes
For a list of error codes, visit the API Error Center.