調用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。 |
返回資料
名稱 | 類型 | 樣本值 | 描述 |
---|---|---|---|
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 |
跨地區備份方式,取值:
|
BackupSetScale | Integer | 0 |
備份檔案的備份策略,取值:
|
BackupSetStatus | Integer | 0 |
備份檔案狀態,取值:
|
BackupStartTime | String | 2019-05-30T12:10Z |
跨地區備份開始時間。格式:yyyy-MM-ddTHH:mmZ(UTC時間)。 |
BackupType | String | F |
跨地區備份類型,取值:
|
Category | String | HighAvailability |
執行個體系列,取值:
|
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&Expires=1560501641&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
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。