調用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 |
目的資料庫版本,取值:
|
DBInstanceClass | String | 是 | rds.mysql.s1.small |
目的執行個體規格,詳見執行個體規格表。 |
DBInstanceStorage | Integer | 是 | 20 |
目的執行個體儲存空間,取值: 5~2000。 每5G進行遞增,單位:GB。詳見執行個體規格表。 |
DBInstanceNetType | String | 是 | Intranet |
目的執行個體的網路連接類型,取值:
|
PayType | String | 是 | Prepaid |
目的執行個體的付費類型,取值:
|
RestoreType | String | 是 | 0 |
恢複方式,取值:
|
SecurityIPList | String | 是 | 127.0.0.1 |
目的執行個體的IP白名單,多個IP地址請以英文逗號(,)隔開,不可重複,最多1000個。支援如下兩種格式:
|
InstanceNetworkType | String | 否 | Classic |
目的執行個體的網路類型,取值:
預設建立傳統網路類型的執行個體。 说明 當本參數值為 VPC時,還需要傳入參數VpcId、VSwitchId。
|
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。 |
SystemDBCharset | String | 否 | uft8 |
目的執行個體的字元集,取值:
|
DBInstanceDescription | String | 否 | 測試資料庫 |
目的執行個體名稱,長度為2~256個字元。以中文、英文字母開頭,可以包含數字、中文、英文、底線(_)、虛線(-)。 说明 不能以 http:// 和 https:// 開頭。
|
ClientToken | String | 否 | ETnLKlblzczshOTUbOCzxxxxxxxxxx |
用於保證請求的等冪性,防止重複提交請求。由用戶端產生該參數值,要保證在不同請求間唯一,最大值不超過64個ASCII字元,且該參數值中不能包含非ASCII字元。 |
PrivateIpAddress | String | 否 | 172.16.201.69 |
設定目的執行個體的內網IP,需要在指定交換器的IP位址範圍內。系統預設通過VPCId和VSwitchId自動分配。 |
Period | String | 否 | Year |
指定預付費目的執行個體為包年或者包月類型,取值:
说明 若付費類型為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 |
指定購買時間長度,取值:
说明 若付費類型為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. | 指定的備份類型無效。 |
訪問錯誤中心查看更多錯誤碼。