調用DescribeBackups介面查看備份組列表。

说明 備份組的狀態BackupStatus必須是Success，才能用於恢複。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱 類型 是否必選 樣本值 描述
Action String 是 DescribeBackups

系統規定參數，取值：DescribeBackups。

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

執行個體ID。
BackupId String 否 327329803

備份組ID。
BackupStatus String 否 Success

備份組狀態。取值：

  • Success：已完成備份；
  • Failed：備份失敗。
BackupMode String 否 Automated

備份模式，取值：

  • Automated：系統自動備份；
  • Manual：手動備份。
StartTime String 否 2011-06-01T16:00Z

查詢開始時間。格式：yyyy-MM-ddTHH:mmZ（UTC時間）。

EndTime String 否 2011-06-15T16:00Z

查詢結束時間，需要大於查詢開始時間。格式：yyyy-MM-ddTHH:mmZ（UTC時間）。

PageSize Integer 否 30

每頁記錄數，取值：

  • 30；
  • 50；
  • 100。

預設值：30。

PageNumber Integer 否 1

頁碼，取值：大於0且不超過Integer的最大值。

預設值：1。

返回資料

名稱 類型 樣本值 描述
TotalRecordCount String 100

總記錄數。
PageNumber String 1

頁碼。
PageRecordCount String 30

本頁備份組個數。
Items

備份組列表。
BackupId String 321020562

備份組ID。
DBInstanceId String rm-uf6wjk5xxxxxxx

執行個體ID。
HostInstanceID String 5882781

產生備份組的執行個體編號，用於區分該備份組產生於主執行個體或備執行個體。
BackupStatus String Success

備份組狀態。
BackupStartTime String 2019-02-03T12:20:00Z

本次備份開始時間。格式：yyyy-MM-ddTHH:mmZ（UTC時間）。

BackupEndTime String 2019-02-13T12:20:00Z

本次備份結束時間。格式：yyyy-MM-ddTHH:mmZ（UTC時間）。

BackupType String FullBackup

備份類型，取值：

  • FullBackup：全量備份；
  • IncrementalBackup：增量備份。
BackupMode String Automated

備份模式，取值：

  • Automated：系統自動備份；
  • Manual：手動備份。
BackupMethod String Physical

備份方式，取值：

  • Logical：邏輯備份；
  • Physical：物理備份。
BackupDownloadURL String http://rdsbak-hz-v3.oss-cn-hangzhou.aliyuncs.com/xxxxx

公網下載地址，若當前不可下載，則為空白串。
BackupIntranetDownloadURL String http://rdsbak-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/xxxxx

內網下載地址，若當前不可下載，則為空白串。
BackupSize Long 2167808

備份檔案大小，單位：Byte。
StoreStatus String Disabled

該資料備份是否可刪除，取值：

  • Enabled：可刪除；
  • Disabled：不可刪除。
MetaStatus String OK

庫表恢複的備份組狀態，取值：

  • OK：正常；
  • LARGE：表數量過多，不能用於庫表恢複；
  • EMPTY：備份失敗的備份組。
说明 空串表示未開通庫表恢複的備份組。
RequestId String 1A6D328C-84B8-40DC-BF49-6C73984D7494

請求ID。

樣本

請求樣本


http(s)://rds.aliyuncs.com/?Action=DescribeBackups
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<公用請求參數>

正常返回樣本

XML 格式 

<DescribeBackupsResponse>
	  <Items>
		    <Backup>
			      <StoreStatus>Disabled</StoreStatus>
			      <HostInstanceID>5882781</HostInstanceID>
			      <BackupLocation>OSS</BackupLocation>
			      <BackupIntranetDownloadURL>http://rdsbak-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/custins10430291/hins5882781_data_20190213201955.tar.gz?OSSAccessKeyId=xxxxxxxx&amp;Expires=1231230&amp;Signature=zIBwxxxxxxx5ga3p%2BVxxxxxxxx%3D</BackupIntranetDownloadURL>
			      <BackupType>FullBackup</BackupType>
			      <DBInstanceId>rm-uf6wjk5xxxxxxx</DBInstanceId>
			      <BackupEndTime>2019-02-13T12:22:53Z</BackupEndTime>
			      <BackupMethod>Physical</BackupMethod>
			      <BackupId>321020562</BackupId>
			      <BackupStartTime>2019-02-13T12:20:37Z</BackupStartTime>
			      <BackupDownloadURL>http://rdsbak-hz-v3.oss-cn-hangzhou.aliyuncs.com/custins10430291/hins5882781_data_20190213201955.tar.gz?OSSAccessKeyId=xxxxxxx&amp;Expires=1231230&amp;Signature=zIBwxxxxxxxxUs5ga3p%2BVxxxxxxxk%3D</BackupDownloadURL>
			      <MetaStatus></MetaStatus>
			      <BackupDBNames>spdb,sys,test20181221,test-20181228,test_20181115,test_20181116</BackupDBNames>
			      <BackupMode>Automated</BackupMode>
			      <BackupSize>2167808</BackupSize>
			      <BackupStatus>Success</BackupStatus>
			      <BackupScale>DBInstance</BackupScale>
		    </Backup>
	  </Items>
	  <TotalBackupSize>8672256</TotalBackupSize>
	  <PageNumber>1</PageNumber>
	  <TotalRecordCount>1</TotalRecordCount>
	  <RequestId>B0E0F374-919F-4BD9-BCAC-AE68122A0D68</RequestId>
	  <PageRecordCount>1</PageRecordCount></DescribeBackupsResponse>

JSON 格式 

{
	"TotalBackupSize":"8672256",
	"Items":{
		"Backup":[
			{
				"StoreStatus":"Disabled",
				"HostInstanceID":5882781,
				"BackupLocation":"OSS",
				"BackupIntranetDownloadURL":"http://rdsbak-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/custins10430291/hins5882781_data_20190213201955.tar.gz?OSSAccessKeyId=xxxxxxxx&Expires=1231230&Signature=zIBwxxxxxxx5ga3p%2BVxxxxxxxx%3D",
				"BackupType":"FullBackup",
				"DBInstanceId":"rm-uf6wjk5xxxxxxx",
				"BackupEndTime":"2019-02-13T12:22:53Z",
				"BackupMethod":"Physical",
				"BackupId":321020562,
				"BackupStartTime":"2019-02-13T12:20:37Z",
				"BackupDownloadURL":"http://rdsbak-hz-v3.oss-cn-hangzhou.aliyuncs.com/custins10430291/hins5882781_data_20190213201955.tar.gz?OSSAccessKeyId=xxxxxxx&Expires=1231230&Signature=zIBwxxxxxxxxUs5ga3p%2BVxxxxxxxk%3D",
				"MetaStatus":"",
				"BackupDBNames":"spdb,sys,test20181221,test-20181228,test_20181115,test_20181116",
				"BackupMode":"Automated",
				"BackupStatus":"Success",
				"BackupSize":2167808,
				"BackupScale":"DBInstance"
			}
		]
	},
	"TotalRecordCount":1,
	"PageNumber":1,
	"RequestId":"B0E0F374-919F-4BD9-BCAC-AE68122A0D68",
	"PageRecordCount":1
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。