Anda dapat memanggil operasi CheckCreateDdrDBInstance untuk memeriksa apakah data instans sumber dapat dipulihkan ke instans tujuan menggunakan set cadangan cross-region.
Sebelum memanggil operasi ini, pastikan instans sumber menjalankan salah satu mesin database berikut:
- MySQL. Untuk informasi selengkapnya, lihat Back up an ApsaraDB RDS for MySQL instance across regions.
- SQL Server. Untuk informasi selengkapnya, lihat Back up an ApsaraDB RDS for SQL Server instance across regions.
-
PostgreSQL. Untuk informasi selengkapnya, lihat Back up an ApsaraDB RDS for PostgreSQL instance across regions.Catatan Jika instans ApsaraDB RDS for PostgreSQL Anda menggunakan arsitektur baru dan dibuat setelah 10 Oktober 2022, fitur ini tidak didukung untuk instans Anda. Untuk informasi selengkapnya, lihat [Notice] SLR authorization is required to create an ApsaraDB RDS for PostgreSQL instance from October 10, 2022.
Debugging
OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.
Parameter permintaan
| Parameter | Type | Wajib | Contoh | Deskripsi |
| Action | String | Yes | CheckCreateDdrDBInstance | Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CheckCreateDdrDBInstance. |
| RegionId | String | Yes | cn-hangzhou | ID wilayah instans tujuan. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru. |
| Engine | String | Yes | MySQL | Mesin database instans tujuan. Nilai yang valid:
|
| EngineVersion | String | Yes | 5.6 | Versi mesin utama instans tujuan. Nilai parameter ini bervariasi berdasarkan nilai parameter Engine.
|
| DBInstanceClass | String | Yes | rds.mysql.s1.small | Tipe instans instans tujuan. Untuk informasi selengkapnya, lihat Primary ApsaraDB RDS instance types. |
| DBInstanceStorage | Integer | Yes | 20 | Kapasitas penyimpanan instans tujuan. Nilai yang valid: 5 hingga 2000. Satuan: GB. Nilai ini harus merupakan kelipatan 5 GB. Untuk informasi selengkapnya, lihat Primary ApsaraDB RDS instance types. |
| RestoreType | String | Yes | 0 | Metode pemulihan yang ingin Anda gunakan. Nilai yang valid:
Nilai default: 0. |
| BackupSetId | String | No | 14358 | ID set cadangan yang digunakan untuk pemulihan. Anda dapat memanggil operasi DescribeCrossRegionBackups untuk mengkueri ID set cadangan tersebut. Catatan Jika Anda menetapkan parameter RestoreType ke 0, Anda juga harus menentukan parameter ini. |
| RestoreTime | String | No | 2019-05-30T03:29:10Z | Titik waktu ke mana Anda ingin memulihkan data. Titik waktu yang Anda tentukan harus lebih awal dari waktu saat ini. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC. Catatan Jika Anda menetapkan parameter RestoreType ke 1, Anda juga harus menentukan parameter ini. |
| SourceRegion | String | No | cn-hangzhou | ID wilayah instans sumber jika Anda ingin memulihkan data ke titik waktu tertentu. Catatan Jika Anda menetapkan parameter RestoreType ke 1, Anda juga harus menentukan parameter ini. |
| SourceDBInstanceName | String | No | rm-uf6wjk5xxxxxxx | ID instans sumber jika Anda ingin memulihkan data ke titik waktu tertentu. Catatan Jika Anda menetapkan parameter RestoreType ke 1, Anda juga harus menentukan parameter ini. |
Parameter respons
| Parameter | Type | Contoh | Deskripsi |
| IsValid | String | true | Menunjukkan apakah data instans sumber dapat dipulihkan lintas wilayah. Nilai yang valid: true dan false. |
| RequestId | String | 1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC | ID permintaan. |
Contoh
Contoh permintaan
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
&<Common request parameters>Contoh respons sukses
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<CheckCreateDdrDBInstanceResponse>
<IsValid>true</IsValid>
<RequestId>346C62D7-8BB9-4516-93E7-25A469EAABCB</RequestId>
</CheckCreateDdrDBInstanceResponse>JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"IsValid" : "true",
"RequestId" : "346C62D7-8BB9-4516-93E7-25A469EAABCB"
}Kode kesalahan
| Kode status HTTP | Kode kesalahan | Pesan kesalahan | Deskripsi |
| 400 | IncorrectDBInstanceType | Current DB instance engine and type does not support operations. | Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung oleh mesin database dan tipe instans tersebut. |
| 400 | InvalidRestoreType.Format | Specified restore type is not valid. | Pesan kesalahan yang dikembalikan karena tipe pemulihan yang ditentukan tidak valid. Tentukan tipe pemulihan yang valid. |
| 400 | NoBackupSetRegion | BackupSetRegion is absence. | Pesan kesalahan yang dikembalikan karena wilayah cadangan tidak ada. |
| 400 | IncorrectBackupSetType | Backup set type should be ddr. | Pesan kesalahan yang dikembalikan karena tipe set cadangan bukan DDR. |
| 400 | NoSourceInstanceName | No SourceDBInstanceName. | Pesan kesalahan yang dikembalikan karena nama instans sumber tidak ditemukan. |
| 400 | NoAvailableDisasterRestoreBakset | No available disaster restore bakset. | Pesan kesalahan yang dikembalikan karena tidak ditemukan set cadangan yang tersedia. |
| 400 | IncorrectBackupSetMethod | Current backup set method does not support operations. | Pesan kesalahan yang dikembalikan karena set cadangan yang ditentukan tidak dapat digunakan untuk memulihkan database dan tabel tertentu. |
| 400 | InvalidBackupType.Format | Specified backup type is not valid. | Pesan kesalahan yang dikembalikan karena tipe cadangan yang ditentukan tidak valid. |
| 400 | IncorrectEngineVersion | Current engine version does not support operations. | Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung oleh versi mesin database yang dijalankan pada instans tersebut. |
| 400 | IncorrectBaksetVersion | Current bakset version does not support operations. | Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung oleh versi set cadangan tersebut. |
| 400 | CrossRegionUnsupportTDE | Cross-region disaster restore not support TDE bakset. | Pesan kesalahan yang dikembalikan karena set cadangan berbasis TDE tidak dapat digunakan untuk memulihkan instans ke wilayah lain. |
| 400 | DisasterRestoreRegionNotMatched | Disaster restore should be operated in the ddr region or source region. | Pesan kesalahan yang dikembalikan karena pemulihan bencana harus dilakukan di wilayah sumber atau wilayah tujuan. |
| 400 | InvalidMinorVersion.NotFound | Specified minor version does not exists. | Pesan kesalahan yang dikembalikan karena versi mesin minor yang ditentukan tidak ada. |
| 400 | InvalidDBInstanceId.MalFormed | The specified parameter DBInstanceId is not valid. | Pesan kesalahan yang dikembalikan karena ID instans tidak valid. Periksa kembali ID instans tersebut. |
| 400 | InvalidEngine.Malformed | Specified engine is not valid. | Pesan kesalahan yang dikembalikan karena mesin database tidak valid. Tentukan mesin database yang valid. |
| 400 | InvalidEngineVersion.Malformed | Specified engine version is not valid. | Pesan kesalahan yang dikembalikan karena versi mesin database yang ditentukan tidak valid. Periksa versi mesin database dan coba lagi. |
| 400 | MissingUserID | The request is missing a user_id parameter. | Pesan kesalahan yang dikembalikan karena parameter user ID yang ditentukan tidak ada. |
| 400 | MissingUID | The request is missing a uid parameter. | Pesan kesalahan yang dikembalikan karena akun yang Anda gunakan tidak ada. |
| 400 | UserPermissionFailure | The request processing has failed due to user permission. | Pesan kesalahan yang dikembalikan karena Anda tidak memiliki izin yang diperlukan. |
| 400 | InvalidServiceType.Format | Specified service type is not valid. | Pesan kesalahan yang dikembalikan karena tipe layanan tidak valid. Tetapkan tipe layanan ke 0 atau 1. Nilai 0 menunjukkan layanan Alibaba Cloud, dan nilai 1 menunjukkan layanan JST. |
| 400 | InvalidStorage.Format | Specified Storage is not valid. | Pesan kesalahan yang dikembalikan karena nilai parameter Storage tidak valid. Tentukan nilai yang valid untuk parameter tersebut. |
| 403 | IncorrectDBType | The current DB type does not support this operation. | Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung oleh mesin database instans tersebut. Tentukan mesin database yang berbeda. |
| 403 | IncorrectDBInstance | The current DB instance does not support this operation. | Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung oleh instans tersebut. |
| 403 | ResourceConfigError | The request processing has failed due to resource config error. | Pesan kesalahan yang dikembalikan karena terjadi kesalahan konfigurasi resource. |
| 404 | RestoreType.NotFound | RestoreType is not found. | Pesan kesalahan yang dikembalikan karena metode pemulihan yang ditentukan tidak ada. |
| 404 | InvalidBackupSetID.NotFound | Specified backup set ID does not exist. | Pesan kesalahan yang dikembalikan karena set cadangan yang ditentukan tidak ada. Tentukan set cadangan yang valid. |
| 404 | InvalidDBInstance.NotFound | The specified instance does not exist or is not supported. | Pesan kesalahan yang dikembalikan karena instans yang ditentukan tidak ditemukan. Periksa ID instans tersebut. |
| 404 | InvalidDBInstanceClass.NotFound | Specified DB instance class is not found. | Pesan kesalahan yang dikembalikan karena tipe instans baru tidak ditemukan atau tidak lagi tersedia untuk pembelian. Pilih tipe instans yang tersedia. |
Untuk daftar kode kesalahan, lihat Service error codes.