调用DescribeBackups接口查看集群的备份列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeBackups |
系统规定参数,取值: DescribeBackups。 |
DBClusterId | String | 是 | am-bp1xxxxxxxx47 |
实例ID。 |
EndTime | String | 是 | 2011-06-15T16:00Z |
查询结束时间,需要大于查询开始时间,格式:yyyy-MM-ddTHH:mmZ。 |
StartTime | String | 是 | 2011-06-01T16:00Z |
查询开始时间,格式:yyyy-MM-ddTHH:mmZ。 |
BackupId | String | 否 | 327329803 |
备份集ID。 |
PageSize | Integer | 否 | 30 |
每页记录数,取值:
默认值:30。 |
PageNumber | Integer | 否 | 1 |
页码,取值:大于0且不超过Integer的最大值。 默认值:1。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Items | Array of Backup |
备份集列表。 |
|
Backup | |||
BackupEndTime | String | 2011-05-30T03:29:00Z |
本次备份结束时间,格式:YYYY-MM-DDTHH:mm:ssZ。 |
BackupId | String | 327329803 |
备份集ID。 |
BackupMethod | String | Snapshot |
备份方法。 Snapshot:快照备份 |
BackupSize | Integer | 2167808 |
备份文件大小,单位:Byte。 |
BackupStartTime | String | 2011-05-30T03:29:00Z |
本次备份开始时间,格式:YYYY-MM-DDTHH:mm:ssZ。 |
BackupType | String | FullBackup |
备份类型。取值:
|
DBClusterId | String | am-bp1xxxxxxxx47 |
实例ID。 |
PageNumber | String | 10 |
页码。 |
PageSize | String | 30 |
本页备份集个数。 |
RequestId | String | 1AD222E9-E606-4A42-BF6D-8A4442913CEF |
请求ID。 |
TotalCount | String | 300 |
总记录数。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DescribeBackups
&DBClusterId=am-bp1xxxxxxxx47
&EndTime=2011-06-15T16:00Z
&StartTime=2011-06-01T16:00Z
&<公共请求参数>
正常返回示例
XML
格式
<TotalCount>300</TotalCount>
<RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>
<PageSize>30</PageSize>
<PageNumber>10</PageNumber>
<Items>
<Backup>
<BackupMethod>Snapshot</BackupMethod>
<BackupEndTime>2011-05-30T03:29:00Z</BackupEndTime>
<BackupSize>2167808</BackupSize>
<DBClusterId>am-bp1xxxxxxxx47 </DBClusterId>
<BackupStartTime>2011-05-30T03:29:00Z</BackupStartTime>
<BackupId>327329803</BackupId>
<BackupType>FullBackup</BackupType>
</Backup>
</Items>
JSON
格式
{
"TotalCount": 300,
"RequestId": "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
"PageSize": 30,
"PageNumber": 10,
"Items": {
"Backup": {
"BackupMethod": "Snapshot",
"BackupEndTime": "2011-05-30T03:29:00Z",
"BackupSize": 2167808,
"DBClusterId": "am-bp1xxxxxxxx47",
"BackupStartTime": "2011-05-30T03:29:00Z",
"BackupId": 327329803,
"BackupType": "FullBackup"
}
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
404 | InvalidDBCluster.NotFound | The DBClusterId provided does not exist in our records. | 您指定的 DBClusterId 不存在,请确认 DBClusterId 值是否正确。 |
访问错误中心查看更多错误码。