調用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

目的資料庫版本,取值:

  • 5.6
  • 5.7
RestoreType String 0

恢複方式,取值:

  • 0:基於備份組恢複,您還需要傳入參數BackupSetID
  • 1:基於時間點恢複,您還需要傳入參數RestoreTimeSourceRegionSourceDBInstanceName

預設值: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. 指定的備份類型無效。

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