全部产品
云市场

DescribeBackups

更新时间:2019-11-19 15:11:14

调用DescribeBackups接口查看集群的备份列表。

请求参数

名称类型是否必选示例值描述
ActionStringDescribeBackups系统规定参数,取值:

DescribeBackups

DBClusterIdStringam-bp1xxxxxxxx47实例ID。
BackupIdString327329803备份集ID。
StartTimeString2011-06-01T16:00Z查询开始时间,格式:yyyy-MM-ddTHH:mmZ。
EndTimeString2011-06-15T16:00Z查询结束时间,需要大于查询开始时间,格式:yyyy-MM-ddTHH:mmZ。
PageSizeInteger30每页记录数,取值:
  • 30;
  • 50;
  • 100
默认值:30。
PageNumberInteger1页码,取值:大于0且不超过Integer的最大值。

默认值:1。

返回数据

名称类型示例值描述
TotalCountString300总记录数。
PageNumberString10页码。
PageSizeString30本页备份集个数。
RequestIdString1AD222E9-E606-4A42-BF6D-8A4442913CEF请求ID。
ItemsList<Backup>-备份集列表。

Backup

参数类型示例值描述
BackupIdString327329803备份集ID。
DBClusterIdStringam-bp1xxxxxxxx47实例ID。
BackupStartTimeString2011-05-30T03:29:00Z本次备份开始时间,格式:”YYYY-MM-DD’T’HH:mm:ssZ”。
BackupEndTimeString2011-05-30T03:29:00Z本次备份结束时间,格式:”YYYY-MM-DD’T’HH:mm:ssZ”。
BackupType String FullBackup 备份类型。取值:
  • FullBackup:全量备份;
  • IncrementalBackup:增量备份。
BackupSize Long 2167808 备份文件大小,单位:Byte。
BackupMethod String Snapshot 备份方法。

Snapshot:快照备份

示例

请求示例

  1. http(s)://[Endpoint]/?Action=DescribeBackups
  2. &DBClusterId=am-bpxxxxxxx
  3. &EndTime=2019-07-27T15:00Z
  4. &StartTime=2019-07-01T15:00Z
  5. &<公共请求参数>

正常返回示例

XML格式

  1. <DescribeBackupsResponse>
  2. <Items>
  3. <Backup>
  4. <BackupType>FullBackup</BackupType>
  5. <BackupEndTime>2019-07-07T19:02:56Z</BackupEndTime>
  6. <BackupMethod>Snapshot</BackupMethod>
  7. <BackupSize>214748364800</BackupSize>
  8. <DBClusterId>am-bpxxxxxxxxxxxxxxxx</DBClusterId>
  9. <BackupStartTime>2019-07-07T18:00:25Z</BackupStartTime>
  10. <BackupId>493504366</BackupId>
  11. </Backup>
  12. </Items>
  13. <PageNumber>1</PageNumber>
  14. <TotalCount>1</TotalCount>
  15. <PageSize>30</PageSize>
  16. <RequestId>9B2F9613-292E-45E3-9653-47857255B33C</RequestId>
  17. </DescribeBackupsResponse>