調用CreateDdrInstance介面跨地區恢複資料到新執行個體。

恢複前可以調用CheckCreateDdrDBInstance介面預檢查某RDS執行個體是否可以用跨地區備份組進行跨地區恢複。

僅適用於如下執行個體:

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

調試

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

請求參數

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

系統規定參數,取值:CreateDdrInstance

RegionId String cn-hangzhou

目的地區ID,可以通過介面DescribeRegions查看地區ID。

Engine String MySQL

目的資料庫類型,取值:MySQL

EngineVersion String 5.6

目的資料庫版本,取值:

  • 5.6
  • 5.7
DBInstanceClass String rds.mysql.s1.small

目的執行個體規格,詳見執行個體規格表

DBInstanceStorage Integer 20

目的執行個體儲存空間,取值: 5~2000

每5G進行遞增,單位:GB。詳見執行個體規格表

DBInstanceNetType String Intranet

目的執行個體的網路連接類型,取值:

  • Internet:公網串連;
  • Intranet:內網串連。
PayType String Prepaid

目的執行個體的付費類型,取值:

  • Postpaid:後付費(隨用隨付);
  • Prepaid:預付費(訂用帳戶)。
RestoreType String 0

恢複方式,取值:

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

目的執行個體的IP白名單,多個IP地址請以英文逗號(,)隔開,不可重複,最多1000個。支援如下兩種格式:

  • IP地址形式,例如:10.23.12.24;
  • CIDR形式,例如:10.23.12.24/24(無類域間路由,24表示了地址中首碼的長度,範圍為1~32)。
InstanceNetworkType String Classic

目的執行個體的網路類型,取值:

  • VPC:VPC網路;
  • Classic:傳統網路。

預設建立傳統網路類型的執行個體。

说明 當本參數值為 VPC時,還需要傳入參數VpcIdVSwitchId
ZoneId String cn-hangzhou-b

目的執行個體的可用性區域ID。多可用性區域用英文冒號(:)分隔。

说明 指定了VPC和交換器時,為匹配交換器對應的可用性區域,該參數必填。
VPCId String vpc-xxxxxxxxxxxx

目的執行個體的VPC ID。當InstanceNetworkType=VPC時,本參數可用。

说明 如果傳入此參數,您還需要傳入參數ZoneId
DBInstanceStorageType String local_ssd

目的執行個體儲存類型,當前僅支援SSD本地碟,預設值:local_ssd

VSwitchId String vsw-xxxxxxxxxxx

目的執行個體的VSwitch ID,多個值用英文逗號(,)隔開。當InstanceNetworkType=VPC時,本參數可用。

说明 如果傳入此參數,您還需要傳入參數ZoneId
AccessKeyId String LTAIfCxxxxxxx

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

ConnectionMode String Standard

目的執行個體的訪問模式,取值:

  • Standard:標準訪問模式;
  • Safe:資料庫代理模式。

預設值:Standard

SystemDBCharset String uft8

目的執行個體的字元集,取值:

  • utf8
  • gbk
  • latin1
  • utf8mb4
DBInstanceDescription String 測試資料庫

目的執行個體名稱,長度為2~256個字元。以中文、英文字母開頭,可以包含數字、中文、英文、底線(_)、虛線(-)。

说明 不能以 http:// 和 https:// 開頭。
ClientToken String ETnLKlblzczshOTUbOCzxxxxxxxxxx

用於保證請求的等冪性,防止重複提交請求。由用戶端產生該參數值,要保證在不同請求間唯一,最大值不超過64個ASCII字元,且該參數值中不能包含非ASCII字元。

PrivateIpAddress String 172.16.201.69

設定目的執行個體的內網IP,需要在指定交換器的IP位址範圍內。系統預設通過VPCIdVSwitchId自動分配。

Period String Year

指定預付費目的執行個體為包年或者包月類型,取值:

  • Year:包年;
  • Month:包月。
说明 若付費類型為Prepaid則該參數必須傳入。
BackupSetId String 14358

基於備份組恢複時,使用的備份組的ID。可以通過介面DescribeCrossRegionBackups查看備份組ID。

说明 RestoreType=0時必傳。
SourceDBInstanceName String rm-uf6wjk5xxxxxxx

基於時間點恢複時,源執行個體的ID。

说明 RestoreType=1時必傳。
SourceRegion String cn-hangzhou

基於時間點恢複時,源地區的ID。

说明 RestoreType=1時必傳。
RestoreTime String 2019-05-30T03:29:10Z

基於時間點恢複時,要恢複的時間節點,需要早於目前時間。格式:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。

说明 RestoreType=1時必傳 。
UsedTime String 2

指定購買時間長度,取值:

  • 當參數PeriodYear時,UsedTime取值為1~3
  • 當參數PeriodMonth時,UsedTime取值為1~9
说明 若付費類型為Prepaid則該參數必須傳入。
ResourceGroupId String rg-acfmyxxxxxxxxxx

資源群組ID。

返回資料

名稱 類型 樣本值 描述
DBInstanceId String rm-xxxxx

新執行個體ID。

ConnectionString String rm-xxxxx.mysql.rds.aliyuncs.com

新執行個體串連地址。

说明 參數DBInstanceNetType決定該地址為內網或外網。
OrderId String 2038691xxxxx

訂單ID。

Port String 3306

新執行個體串連連接埠。

说明 參數DBInstanceNetType決定該連接埠為內網連接埠或外網連接埠。
RequestId String E52666CC-330E-418A-8E5B-A19E3FB42D13

請求ID。

樣本

請求樣本


http(s)://rds.aliyuncs.com/?Action==CreateDdrInstance
&RegionId=cn-hangzhou
&Engine=MySQL
&EngineVersion=5.6
&DBInstanceClass=rds.mysql.s1.small
&DBInstanceStorage=20
&DBInstanceNetType=Intranet
&PayType=Prepaid
&RestoreType=0
&SecurityIPList=127.0.0.1
&BackupSetId=14358
&<公用請求參數>

正常返回樣本

XML 格式

<CreateDdrInstanceResponse>
  <ConnectionString>rm-xxxxx.mysql.rds.aliyuncs.com</ConnectionString>
	  <Port>3306</Port>
	  <RequestId>E52666CC-330E-418A-8E5B-A19E3FB42D13</RequestId>
	  <DBInstanceId>rm-xxxxx</DBInstanceId>
	  <OrderId>2038691xxxxx</OrderId>
</CreateDdrInstanceResponse>

JSON 格式

{
	"Port":"3306",
	"ConnectionString":"rm-xxxxx.mysql.rds.aliyuncs.com",
	"OrderId":"2038691xxxxx",
	"DBInstanceId":"rm-xxxxx",
	"RequestId":"E52666CC-330E-418A-8E5B-A19E3FB42D13"
}

錯誤碼

HttpCode 錯誤碼 錯誤資訊 描述
400 InvalidZoneId.NotSupported The Specified vpc Zone not supported. 當前可用性區域不支援生產 VPC 執行個體,請您更換可用性區域再試。
400 InvalidDBInstanceName.Format Specified DB instance name is not valid. 指定的DB執行個體名不正確。
400 InvalidServiceType.Format Specified service type is not valid. 指定的服務類型無效。
400 InvalidEngine.Malformed Specified engine is not valid. 指定資料庫引擎無效。
400 InvalidEngineVersion.Malformed Specified engine version is not valid. 指定資料庫引擎版本無效。
400 InvalidConnectionString.Format Specified connection string is not valid. 指定的連接字串無效。
400 InvalidConnectionString.Duplicate Specified connection string already exists in the Aliyun RDS. 在阿里雲RDS中已經存在指定的連接字串。
400 InvalidCharacterSetName.Format Specified character set name is not valid. 指定的字元集名稱無效。
400 InvalidDBInstanceType.Format Specified instance type is not valid. 指定執行個體類型無效。
400 InvalidPort.Malformed Specified port is not valid. 指定連接埠無效。
400 InvalidBackupRetentionPeriod.Malformed Specified backup retention period is not valid. 指定的備份保留期無效。
400 InvalidPreferredBackupTime.Format Specified preferred backup time is not valid. 指定的期望備份時間無效。
400 InvalidPreferredBackupPeriod.Malformed Specified backup period is not valid. 指定的期望備份時間無效。
404 InvalidDBInstanceClass.NotFound Specified DB instance class is not found. 執行個體規格無效,請檢查該參數是否正確。
404 InvalidDBInstanceNetType.NotFound Specified DB instance net type is not found. 指定DB執行個體網路類型不存在。
400 InvalidOptmizationService Specified optmization service is not valid. 參數OptmizationService無效
400 InvalidExpiredTime.Format Specified expired time is not valid. 指定的失效時間不正確。
400 InvalidSecurityIPList.Format Specified security IP list format is not valid. 指定的安全IP列表格式不正確。
400 InvalidSecurityIPList.QuotaExceeded Specified security IP list is not valid: Exceeding the allowed amount of IP address in the list. 指定的安全IP列表中包含的IP地址數超過允許上限。
400 InvalidDBInstanceDescription.Format Specified DB instance description is not valid. 指定的DB執行個體描述無效。
400 InvalidStorage.Format Specified Storage is not valid. 指定的Storage參數無效。
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. 指定的備份類型無效。

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