調用DescribeCrossRegionBackups介面查看某RDS執行個體跨地區資料備份檔案清單。

查看記錄備份檔案請參見DescribeCrossRegionLogBackupFiles。

僅適用於如下執行個體：

  • MySQL 5.7高可用本地SSD盤版
  • MySQL 5.6

調試

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

請求參數

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

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

DBInstanceId String 是 rm-uf6wjk5xxxxxxxxxx

執行個體ID。
RegionId String 是 cn-hangzhou

執行個體所在地區ID。
AccessKeyId String 否 LTAIfCxxxxxxx

阿里雲頒發給使用者的訪問服務所用的密鑰ID。
CrossBackupId Integer 否 14562

跨地區備份檔案ID。

说明 CrossBackupId和起止時間參數（StartTime、EndTime）必須傳入其中一組。
StartTime String 否 2019-05-30T12:10Z

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

EndTime String 否 2019-06-15T12:10Z

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

PageNumber Integer 否 1

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

預設值：1。

CrossBackupRegion String 否 cn-shanghai

跨地區備份目的地區ID。
PageSize Integer 否 30

每頁記錄數，取值：

  • 30；
  • 50；
  • 100。

預設值：30。

返回資料

名稱 類型 樣本值 描述
RegionId String cn-hangzhou

執行個體所在地區ID。
StartTime String 2019-05-30T12:10Z

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

EndTime String 2019-06-15T12:10Z

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

TotalRecordCount Integer 100

總記錄數。
PageNumber Integer 1

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

預設值：1。

PageRecordCount Integer 30

本頁備份檔案個數。
RequestId String 60912B41-7579-4B5D-B289-8856030F0A6A

請求ID。
Items

跨地區備份列表。
BackupEndTime String 2019-06-15T12:10Z

跨地區備份結束時間。格式：yyyy-MM-ddTHH:mmZ（UTC時間）。

BackupMethod String P

跨地區備份方式，取值：

  • L：邏輯備份；
  • P：物理備份。
BackupSetScale Integer 0

備份檔案的備份策略，取值：

  • 0：執行個體備份；
  • 1：單庫備份。
BackupSetStatus Integer 0

備份檔案狀態，取值：

  • 0：完成備份；
  • 1：備份失敗。
BackupStartTime String 2019-05-30T12:10Z

跨地區備份開始時間。格式：yyyy-MM-ddTHH:mmZ（UTC時間）。

BackupType String F

跨地區備份類型，取值：

  • F：全量；
  • I：增量。
Category String HighAvailability

執行個體系列，取值：

  • Basic：基礎版；
  • HighAvailability：高可用版；
  • Finance：金融版（僅中國站支援）。
ConsistentTime String 2019-06-12T05:44:46Z

備份檔案裡資料的時間點。
CrossBackupDownloadLink String http://rdsddrbak-shanghai.oss-cn-shanghai.aliyuncs.com/xxxxx

跨地區備份檔案外網下載連結。
CrossBackupId Integer 14377

跨地區備份檔案ID。
CrossBackupRegion String cn-shanghai

跨地區備份的目的地區ID。
CrossBackupSetFile String cn-hangzhou_rm-xxxxx_hins81xxx_data_20190612134426_qp.xb

跨地區備份檔案壓縮包名稱。
CrossBackupSetLocation String oss

備份檔案儲存位置。
CrossBackupSetSize Long 5312836

跨地區備份檔案大小，單位：Byte。
DBInstanceStorageType String ssd

儲存類型。
Engine String MySQL

資料庫類型。
EngineVersion String 5.6

資料庫版本。
InstanceId Integer 8161055

執行個體編號。用於區分該備份組產生於主執行個體或備執行個體。
RestoreRegions "cn-hangzhou", "cn-shanghai"

備份檔案可以進行恢複的地區列表，即備份檔案可以恢複到哪些地區。

樣本

請求樣本


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

正常返回樣本

XML 格式 

<DescribeCrossRegionBackupsResponse>
  <Items>
		    <Item>
			      <CrossBackupSetFile>cn-hangzhou_rm-bpxxxxx_hins798xxxx_data_20190611125201.tar.gz</CrossBackupSetFile>
			      <BackupSetScale>0</BackupSetScale>
			      <BackupType>F</BackupType>
			      <InstanceId>7980000</InstanceId>
			      <CrossBackupId>14358</CrossBackupId>
			      <BackupEndTime>2019-06-11T04:55:02Z</BackupEndTime>
			      <BackupMethod>P</BackupMethod>
			      <CrossBackupSetLocation>oss</CrossBackupSetLocation>
			      <CrossBackupSetSize>2179643</CrossBackupSetSize>
			      <Engine>mysql</Engine>
			      <BackupStartTime>2019-06-11T04:52:46Z</BackupStartTime>
			      <CrossBackupDownloadLink>http://rdsddrbak-zb.oss-cn-zhangjiakou.aliyuncs.com/cn-hangzhou_rm-bpxxxxx_hins7986073_data_20190611125201.tar.gz?OSSAccessKeyId=LTAxxxxx&amp;Expires=1560501641&amp;Signature=laK0kxxxxx%3D</CrossBackupDownloadLink>
			      <Category>HighAvailability</Category>
			      <CrossBackupRegion>cn-zhangjiakou</CrossBackupRegion>
			      <RestoreRegions>
				        <RestoreRegion>cn-hangzhou</RestoreRegion>
				        <RestoreRegion>cn-zhangjiakou</RestoreRegion>
			      </RestoreRegions>
			      <EngineVersion>5.7</EngineVersion>
			      <DBInstanceStorageType>ssd</DBInstanceStorageType>
		    </Item>
	  </Items>
	  <TotalRecordCount>1</TotalRecordCount>
	  <PageNumber>1</PageNumber>
	  <RequestId>60912B41-7579-4B5D-B289-8856030F0A6A</RequestId>
	  <RegionId>cn-hangzhou</RegionId>
	  <EndTime>2019-06-11T08:00:00Z</EndTime>
	  <StartTime>2019-06-10T00:00:00Z</StartTime>
	  <PageRecordCount>30</PageRecordCount>
    </DescribeCrossRegionBackupsResponse>

JSON 格式 

{
	"Items":{
		"Item":[
			{
				"CrossBackupSetFile":"cn-hangzhou_rm-bpxxxxx_hins798xxxx_data_20190611125201.tar.gz",
				"BackupSetScale":0,
				"BackupType":"F",
				"InstanceId":7980000,
				"CrossBackupId":14358,
				"BackupEndTime":"2019-06-11T04:55:02Z",
				"BackupMethod":"P",
				"CrossBackupSetLocation":"oss",
				"CrossBackupSetSize":2179643,
				"Engine":"mysql",
				"BackupStartTime":"2019-06-11T04:52:46Z",
				"CrossBackupDownloadLink":"http://rdsddrbak-zb.oss-cn-zhangjiakou.aliyuncs.com/cn-hangzhou_rm-bpxxxxx_hins7986073_data_20190611125201.tar.gz?OSSAccessKeyId=LTAxxxxx&Expires=1560501641&Signature=laK0kxxxxx%3D",
				"Category":"HighAvailability",
				"CrossBackupRegion":"cn-zhangjiakou",
				"RestoreRegions":{
					"RestoreRegion":[
						"cn-hangzhou",
						"cn-zhangjiakou"
					]
				},
				"EngineVersion":"5.7",
				"DBInstanceStorageType":"ssd"
			}
		]
	},
	"PageNumber":1,
	"TotalRecordCount":1,
	"RegionId":"cn-hangzhou",
	"RequestId":"60912B41-7579-4B5D-B289-8856030F0A6A",
	"EndTime":"2019-06-11T08:00:00Z",
	"StartTime":"2019-06-10T00:00:00Z",
	"PageRecordCount":30
}

錯誤碼

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