Memulihkan data ke instans baru lintas wilayah.
Deskripsi operasi
Saran
Sebelum Anda melakukan pemulihan, panggil operasi CheckCreateDdrDBInstance untuk memeriksa apakah kumpulan cadangan lintas wilayah dari instans ApsaraDB RDS tujuan dapat digunakan untuk pemulihan lintas wilayah.
Engine yang didukung
ApsaraDB RDS for MySQL
ApsaraDB RDS for PostgreSQL
ApsaraDB RDS for SQL Server
Dokumentasi terkait
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
rds:CreateDdrInstance |
create |
*全部资源
|
None | None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
ID wilayah tujuan. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah. |
cn-hangzhou |
| Engine |
string |
Yes |
Jenis engine basis data tujuan. Nilai yang valid:
|
MySQL |
| EngineVersion |
string |
Yes |
Versi engine basis data tujuan. Nilai yang valid bervariasi berdasarkan nilai Engine:
Catatan
Untuk instans SQL Server, |
5.6 |
| DBInstanceClass |
string |
No |
Spesifikasi instans tujuan. Untuk detail, lihat Tabel Spesifikasi Instans. |
rds.mysql.s1.small |
| DBInstanceStorage |
integer |
No |
Ruang penyimpanan instans tujuan. Nilai: 5~2000. Menaik setiap 5 GB, satuan: GB. Untuk detail, lihat Tabel Spesifikasi Instans. |
20 |
| SystemDBCharset |
string |
No |
Set karakter instans tujuan. Nilai:
|
uft8 |
| DBInstanceNetType |
string |
Yes |
Tipe koneksi jaringan instans tujuan. Nilai:
|
Intranet |
| DBInstanceDescription |
string |
No |
Nama instans tujuan. Panjangnya 2~256 karakter. Harus dimulai dengan karakter Tionghoa atau huruf, dan dapat berisi angka, karakter Tionghoa, huruf, garis bawah (_), dan tanda hubung (-). Catatan
Tidak boleh dimulai dengan |
testdb |
| SecurityIPList |
string |
Yes |
Daftar IP yang diizinkan untuk instans tujuan. Beberapa alamat IP harus dipisahkan dengan koma (,), tidak boleh duplikat, maksimum 1000. Mendukung dua format berikut:
|
127.0.0.1 |
| ClientToken |
string |
No |
Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan token tersebut unik di antara permintaan yang berbeda. Token hanya dapat berisi karakter ASCII dan tidak boleh melebihi 64 karakter. |
ETnLKlblzczshOTUbOCz**** |
| PayType |
string |
Yes |
Tipe pembayaran instans tujuan. Nilai:
|
Prepaid |
| ZoneId |
string |
No |
ID zona ketersediaan instans tujuan. Beberapa zona ketersediaan dipisahkan dengan titik dua (:). Catatan
Ketika VPC dan vSwitch ditentukan, parameter ini wajib diisi agar cocok dengan zona ketersediaan vSwitch. |
cn-hangzhou-b |
| InstanceNetworkType |
string |
No |
Tipe jaringan instans tujuan. Nilai:
Catatan
Ketika VPC dipilih, Anda juga harus meneruskan parameter VpcId dan VSwitchId. |
Classic |
| ConnectionMode |
string |
No |
Mode akses dari instans tujuan. Nilai yang valid:
|
Standard |
| VPCId |
string |
No |
ID VPC dari instans tujuan. Catatan
|
vpc-**** |
| VSwitchId |
string |
No |
ID vSwitch dari instans tujuan. Beberapa nilai dipisahkan dengan koma (,). Catatan
|
vsw-**** |
| PrivateIpAddress |
string |
No |
Mengatur IP internal untuk instans tujuan, yang harus berada dalam rentang alamat IP vSwitch yang ditentukan. Secara default, sistem mengalokasikannya secara otomatis melalui VPCId dan VSwitchId. |
172.XX.XX.69 |
| UsedTime |
string |
No |
Durasi langganan. Nilai yang valid:
Catatan
Parameter ini wajib ketika PayType diatur ke Prepaid. |
2 |
| Period |
string |
No |
Menentukan instans tujuan pra-bayar sebagai tipe langganan tahunan atau bulanan. Nilai:
Catatan
Parameter ini wajib jika tipe pembayaran adalah Prepaid. |
Year |
| ResourceGroupId |
string |
No |
ID grup sumber daya. |
rg-acfmy**** |
| RestoreType |
string |
Yes |
Metode pemulihan. Nilai yang valid:
|
BackupSet |
| BackupSetId |
string |
No |
ID kumpulan cadangan yang digunakan untuk pemulihan dari kumpulan cadangan. Anda dapat memanggil operasi DescribeCrossRegionBackups untuk mengkueri ID kumpulan cadangan. Catatan
Parameter ini wajib ketika RestoreType diatur ke BackupSet. |
14**** |
| BackupSetRegion |
string |
No |
Wilayah tempat kumpulan cadangan berada. |
cn-beijing |
| RestoreTime |
string |
No |
Titik waktu yang Anda inginkan untuk memulihkan data ketika Anda melakukan pemulihan titik waktu. Titik waktu harus lebih awal dari waktu saat ini. Format: yyyy-MM-ddTHH:mm:ssZ (UTC). Catatan
Parameter ini wajib ketika RestoreType diatur ke BackupTime. |
2019-05-30T03:29:10Z |
| SourceRegion |
string |
No |
ID wilayah dari instans sumber untuk pemulihan titik waktu. Catatan
Parameter ini wajib ketika RestoreType diatur ke BackupTime. |
cn-hangzhou |
| SourceDBInstanceName |
string |
No |
ID dari instans sumber untuk pemulihan titik waktu. Catatan
Parameter ini wajib ketika RestoreType diatur ke BackupTime. |
rm-uf6wjk5**** |
| DBInstanceStorageType |
string |
No |
Tipe penyimpanan instans tujuan. Nilai: Catatan
Disarankan untuk konsisten dengan tipe penyimpanan instans sumber. |
local_ssd |
| RoleARN |
string |
No |
Deskriptor sumber daya global (ARN) yang digunakan oleh akun utama instans SQL Server untuk memberi otorisasi akun layanan cloud RDS mengakses izin KMS. Anda dapat melihat informasi ARN melalui antarmuka CheckCloudResourceAuthorized. |
acs:ram::1406****:role/aliyunrdsinstanceencryptiondefaultrole |
| EncryptionKey |
string |
No |
ID kunci enkripsi kustom untuk enkripsi disk cloud dari instans SQL Server. Menentukan parameter ini mengaktifkan enkripsi disk cloud, yang tidak dapat dinonaktifkan setelah diaktifkan. Anda juga harus menentukan RoleARN. Anda dapat melihat ID kunci layanan di konsol Service Key Management Service (KMS) atau membuat kunci baru. Catatan
Anda juga dapat menghilangkan parameter ini dan hanya menentukan RoleARN untuk mengatur tipe enkripsi disk cloud ke CMK Layanan Default yang dikelola RDS. |
749c1df7-****-****-****-**** |
Contoh penggunaan SQL Server
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Parameter respons. |
||
| ConnectionString |
string |
Endpoint dari instans baru. Catatan
Nilai DBInstanceNetType menentukan apakah endpoint ini adalah endpoint internal atau publik. |
rm-****.mysql.rds.aliyuncs.com |
| DBInstanceId |
string |
ID instans baru. |
rm-**** |
| OrderId |
string |
ID pesanan. |
2038691**** |
| Port |
string |
Port dari instans baru. Catatan
Nilai DBInstanceNetType menentukan apakah port ini adalah port internal atau publik. |
3306 |
| RequestId |
string |
ID permintaan. |
E52666CC-330E-418A-8E5B-A19E3FB42D13 |
Contoh
Respons sukses
JSONformat
{
"ConnectionString": "rm-****.mysql.rds.aliyuncs.com",
"DBInstanceId": "rm-****",
"OrderId": "2038691****",
"Port": "3306",
"RequestId": "E52666CC-330E-418A-8E5B-A19E3FB42D13"
}
Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidZoneId.NotSupported | The Specified vpc Zone not supported. | |
| 400 | InvalidDBInstanceName.Format | Specified DB instance name is not valid. | |
| 400 | InvalidDBInstanceName.Duplicate | Specified DB instance name already exists in the Aliyun RDS. | |
| 400 | InvalidRegion.Format | Specified Region is not valid. | |
| 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. | |
| 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. | |
| 400 | InvalidOptmizationService | Specified optmization service is not valid. | |
| 400 | InvalidExpiredTime.Format | Specified expired time is not valid. | |
| 400 | InvalidSecurityIPList.Format | Specified security IP list format is not valid. | |
| 400 | InvalidSecurityIPList.Duplicate | Specified security IP list is not valid: Duplicate IP address in the list | |
| 400 | InvalidSecurityIPList.QuotaExceeded | Specified security IP list is not valid: Exceeding the allowed amount of IP address in the list. | |
| 400 | InvalidDBInstanceDescription.Format | Specified DB instance description is not valid. | |
| 400 | InvalidStorage.Format | Specified Storage is not valid. | |
| 400 | InvalidDBInstanceConnType.Format | Specified DB instance conn type is not valid. | |
| 400 | PreCheckInvalid | CreateDdrInstance PreCheck Is Invalid | |
| 400 | IncorrectDBInstanceType | Current DB instance engine and type does not support operations. | |
| 400 | InvalidRestoreType.Format | Specified restore type is not valid. | |
| 400 | NoBackupSetRegion | BackupSetRegion is absence. | |
| 400 | IncorrectBackupSetType | Backup set type should be value ddr. | |
| 400 | NoBaksetName | BaksetName is absence. | |
| 400 | NoSourceInstanceName | No SourceDBInstanceName. | |
| 400 | NoAvailableDisasterRestoreBakset | No available disaster restore bakset. | |
| 400 | InvalidBackupType.Format | Specified backup type is not valid. | |
| 400 | IncorrectEngineVersion | Current engine version does not support operations. | |
| 400 | DisasterRestoreRegionNotMatched | Disaster restore should be operated in the ddr region or source region. | |
| 400 | InvalidVpcIdRegion.NotSupported | The Specified vSwitchId zone not supported. | |
| 400 | VswitchIpExhausted | No available ip in the specified vswitch. | |
| 400 | Order.ComboInstanceNotAllowOperate | A package instance is not allowed to operate independently. | |
| 400 | Price.PricingPlanResultNotFound | Pricing plan price result not found. | |
| 400 | Order.NoRealNameAuthentication | You have not passed the real-name authentication and do not meet the purchase conditions. Please log in to the user center for real-name authentication. | |
| 400 | InsufficientAvailableQuota | Your account quota limit is less than 0, please recharge before trying to purchase. | |
| 400 | CommodityServiceCalling.Exception | Failed to call commodity service. | |
| 400 | RegionDissolvedEOM | Dear customer, Alibaba Cloud plans to optimize and adjust the current region. Cloud services in this region will cease operations. You are currently unable to operate new purchase orders. Thank you for your understanding and support. | |
| 400 | Commodity.InvalidComponent | The module you purchased is not legal, please buy it again. | |
| 400 | RegionEndTimeDissolvedAustralia | Cloud services in the Australia (Sydney) region will be discontinued. Set the validity date to September 30, 2024 or earlier than September 30, 2024. | |
| 400 | Price.CommoditySys | Commodity system call exception. | |
| 400 | Pay.InsufficientBalance | Insufficient available balance. | |
| 400 | Order.PeriodInvalid | There is a problem with the period you selected, please choose again. | |
| 400 | pay.noCreditCard | Account not bound to credit card. | |
| 400 | Order.InstHasUnpaidOrder | There is an unpaid order for the service you have purchased. Please pay or void it before placing the order. | |
| 400 | noAvailablePaymentMethod | No payment method is specified for your account. We recommend that you add a payment method. | |
| 400 | BasicInfoUncompleted | Your information is incomplete. Complete your information before the operation. | |
| 400 | Risk.RiskControlRejection | Your account is abnormal, please contact customer service for details. | |
| 400 | Api.NotSupport | Specified api is not supported. | |
| 400 | ContainForbiddenLabelError | There is a label that prohibits placing orders. Please contact your distributor for assistance. | |
| 400 | InvalidDBInstanceId.NotFound | The DBInstanceId provided does not exist in records. | |
| 400 | InvalidInstanceLevel.DiskType | Specified instance level not support request disk type | |
| 400 | InvalidParam | Sepcified wal level Parameter is invalid. There are still logical slots in instance, so it can not be set as replica. | |
| 400 | KmsApiError | User secret key invalid. | |
| 400 | System.SaleValidateFailed | Sales expression validation system error. | |
| 400 | Abs.InvalidAccount.NotFound | account is not found. | |
| 400 | SqlExecuteFailedOrTimeout | sql command execution failed or timed out:%s. | |
| 400 | ColdData.EngineVersionNotSupport | The current instance engine version not support coldDataEnabled. | |
| 400 | ColdData.MinorVersionNotSupport | The current instance minor version not support coldDataEnabled. | |
| 400 | IncorrectTargetClasscode | The current instance type does not support this operation. | |
| 400 | RequiredParam.NotFound | Required input param is not found. | |
| 400 | Parameters.Invalid | Parameter error, please check the parameters. | |
| 400 | BackupPolicyNotSupport | Cold Data won't open with CrossBackup or Flash Backup, please check Backup Policy. | |
| 400 | InvalideStatus.Format | The instance status does not support this operation. | |
| 400 | InvalidReleasedKeepPolicy.Format | Specified Released Keep Policy is not valid. | |
| 400 | InvalidDBInstanceEngineType.Format | the DB instance engine type does not support this operation. | |
| 400 | Pay.NoCreditCard | No credit cards. | |
| 400 | VpcNetworkTypeNotSupport | The vpc network type instance does not support this operation. | |
| 400 | MirrorInsExists | Specified DB instance mirror ins already existed. | |
| 400 | UnsupportedClassCode | The specified DB instance class stops selling. | |
| 400 | InvalidBackupSet | The specified database does not exist in the backup set. | |
| 400 | OrdTCommodityQueryError | Failed to query for product. | |
| 400 | ProductInstanceReleased | The instance has been released. Please check before placing the order. | |
| 400 | RegionEndTimeDissolvedIndia | The region is no longer supported. | |
| 500 | ExternalFailure | The request processing has failed due to external service failure. | |
| 500 | RequestMetaDataFailed | The service request failed. Please try again later or contact service personnel. | |
| 500 | InvokeProxyFailure | The request processing has failed due to service failure of rds api. | |
| 403 | IncorrectBackupSetMethod | Current backup set method does not support operations. | |
| 403 | IncorrectBaksetVersion | Current bakset version does not support operations. | |
| 403 | CrossRegionUnsupportTDE | Cross-region disaster restore not support TDE bakset. | |
| 403 | OperationDenied.Resource | Specified DB instance class or storage is not available in all Availability Zones. | |
| 403 | OperationDenied.ZoneResource | There is no available zone for inventory. | |
| 403 | OrderStatus.UnPaid | The specified db instance has unpaid order. | |
| 403 | InvalidReduceDiskSize | The storage capacity after the scale-down must be larger than the used amount. | |
| 403 | CloudSSDNotSupport | Cloud ssd does not support this operation, please upgrade to essd. | |
| 403 | InvalidUserOperatorPermission | The user permission does not support this operation. | |
| 403 | InvalidVswitchId | Specified conn vswitch id is not valid. | |
| 403 | IncorrectMinorVersion | Current engine minor version does not support operations. | |
| 403 | NotInFlowController | Sorry,no permission. | |
| 403 | InvalidKmsKey | Kms key is disabled. | |
| 403 | InvalidInstanceLevel.Malformed | Current DB instance level does not support this operation. | |
| 404 | InvalidRegion.NotFound | Specified Region does not exist in the RDS | |
| 404 | InvalidClusterName.NotFound | The specified cluster name is not available. | |
| 404 | InvalidDBInstanceClass.NotFound | Specified DB instance class is not found. | |
| 404 | InvalidDBInstanceNetType.NotFound | Specified DB instance net type is not found. | |
| 404 | RestoreType.NotFound | RestoreType is not found. | |
| 404 | InvalidBackupSetID.NotFound | Specified backup set ID does not exist. | |
| 404 | InvalidClusterKms | The current instance does not authorized to access the Key Management Service. | |
| 404 | Request.NotFound | The requested resource is not available. | |
| 404 | HostInfo.NotFound | The specified host info is not found. |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.