› 推特 ›阿里云技术文档›正文

DescribeBackups_备份恢复_API参考_分析型数据库MySQL版

admin 阿里云技术文档 2020-02-11 182 0
阿里云服务器优惠

DescribeBackups

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

请求参数

名称类型是否必选示例值描述
ActionString是DescribeBackups系统规定参数，取值：

DescribeBackups。

DBClusterIdString是am-bp1xxxxxxxx47实例ID。
BackupIdString否327329803备份集ID。
StartTimeString是2011-06-01T16:00Z查询开始时间，格式：yyyy-MM-ddTHH:mmZ。
EndTimeString是2011-06-15T16:00Z查询结束时间，需要大于查询开始时间，格式：yyyy-MM-ddTHH:mmZ。
PageSizeInteger否30每页记录数，取值：
  • 30；
  • 50；
  • 100
默认值：30。
PageNumberInteger否1页码，取值：大于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>
版权声明

本文仅代表作者观点，不代表本站立场。
本文系作者授权发表，未经许可，不得转载。

评论

-----