調用CheckCreateDdrDBInstance介面預檢查某RDS執行個體是否可以用跨地區備份組進行跨地區恢複。
僅適用於如下執行個體:
- MySQL 5.7高可用本地SSD盤版
- MySQL 5.6
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
請求參數
名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CheckCreateDdrDBInstance |
系統規定參數,取值:CheckCreateDdrDBInstance。 |
RegionId | String | 是 | cn-hangzhou |
目的執行個體地區ID,可以通過介面DescribeRegions查看地區ID。 |
Engine | String | 是 | MySQL |
目的資料庫類型,取值:MySQL。 说明 當前僅RDS for MySQL支援跨地區備份。
|
DBInstanceClass | String | 是 | rds.mysql.s1.small |
目的執行個體規格,詳見執行個體規格表。 |
DBInstanceStorage | Integer | 是 | 20 |
目的執行個體儲存空間,取值: 5~2000。 每5G進行遞增,單位:GB。詳見執行個體規格表。 |
EngineVersion | String | 是 | 5.6 |
目的資料庫版本,取值:
|
RestoreType | String | 是 | 0 |
恢複方式,取值:
預設值:0。 |
AccessKeyId | String | 否 | LTAIfCxxxxxxx |
阿里雲頒發給使用者的訪問服務所用的密鑰ID。 |
BackupSetId | String | 否 | 14358 |
基於備份組恢複時,使用的備份組的ID。可以通過介面DescribeCrossRegionBackups查看備份組ID。 说明 RestoreType=0時必傳。
|
RestoreTime | String | 否 | 2019-05-30T03:29:10Z |
基於時間點恢複時,要恢複的時間節點,需要早於目前時間。格式:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。 说明 RestoreType=1時必傳 。
|
SourceRegion | String | 否 | cn-hangzhou |
基於時間點恢複時,源地區的ID。 说明 RestoreType=1時必傳。
|
SourceDBInstanceName | String | 否 | rm-uf6wjk5xxxxxxx |
基於時間點恢複時,源執行個體的ID。 说明 RestoreType=1時必傳。
|
返回資料
名稱 | 類型 | 樣本值 | 描述 |
---|---|---|---|
IsValid | String | true |
是否能建立容災恢複執行個體,取值:true | false |
RequestId | String | 1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC |
請求ID。 |
樣本
請求樣本
http(s)://rds.aliyuncs.com/?Action=CheckCreateDdrDBInstance
&RegionId=cn-hangzhou
&Engine=MySQL
&DBInstanceClass=rds.mysql.s1.small
&DBInstanceStorage=20
&EngineVersion=5.6
&RestoreType=0
&BackupSetId=14358
&<公用請求參數>
正常返回樣本
XML
格式
<CheckCreateDdrDBInstanceResponse>
<IsValid>true</IsValid>
<RequestId>346C62D7-8BB9-4516-93E7-25A469EAABCB</RequestId>
</CheckCreateDdrDBInstanceResponse>
JSON
格式
{
"IsValid":"true",
"RequestId":"346C62D7-8BB9-4516-93E7-25A469EAABCB"
}
錯誤碼
HttpCode | 錯誤碼 | 錯誤資訊 | 描述 |
---|---|---|---|
400 | IncorrectDBInstanceType | Current DB instance engine and type does not support operations. | 當前DB執行個體引擎和類型不支援操作。 |
400 | InvalidRestoreType.Format | Specified restore type is not valid. | 指定的恢複類型無效。 |
400 | InvalidBackupType.Format | Specified backup type is not valid. | 指定的備份類型無效。 |
訪問錯誤中心查看更多錯誤碼。