All Products
Search

This Product

    :Pulihkan data ke instans baru

    Document Center

    :Pulihkan data ke instans baru

    Last Updated:May 26, 2026

    Anda dapat memanggil operasi CloneDBInstance untuk memulihkan data dari instans asli ke instans baru, yang disebut sebagai instans kloning.

    Sebelum memanggil operasi ini, pastikan persyaratan berikut terpenuhi:

    • Instans asli berada dalam status Running.
    • Instans asli tidak memiliki tugas migration yang sedang berjalan.
    • Fitur log backup diaktifkan pada instans asli untuk mendukung point-in-time recovery.
    • Jika Anda ingin mengkloning instans asli menggunakan backup sets, instans asli harus memiliki setidaknya satu backup set.
    Catatan ApsaraDB RDS memungkinkan Anda mengkloning instans dengan menggunakan kredensial RAM user. Pastikan RAM user telah diberikan permission yang diperlukan untuk mengkloning instans. Untuk informasi selengkapnya, lihat Gunakan RAM untuk mengelola permission ApsaraDB RDS.

    Perhatikan hal-hal berikut:

    • Instans baru memiliki pengaturan Daftar putih alamat IP, SQL Explorer (SQL Audit), ambang batas peringatan, backup, dan parameter yang sama dengan instans asli.
    • Informasi akun dan data pada instans baru sama dengan informasi akun dan data yang terdapat dalam file backup atau titik waktu yang digunakan untuk pemulihan instans asli.

    Debugging

    OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

    Parameter permintaan

    Parameter Tipe Wajib Contoh Deskripsi
    Action String Tidak CloneDBInstance

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CloneDBInstance.
    RegionId String Tidak cn-hangzhou

    ID wilayah untuk instans baru. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.
    ZoneId String Tidak cn-hangzhou-b

    ID zona untuk instans utama. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar zona terbaru.

    Catatan Nilai default parameter ini adalah ID zona tempat instans asli berada.
    DBInstanceClass String Tidak mysql.n1.micro.1

    Tipe instans untuk instans baru. Untuk informasi selengkapnya, lihat Tipe instans utama ApsaraDB RDS.

    Catatan Nilai default parameter ini adalah tipe instans dari instans utama.
    DBInstanceStorage Integer Tidak 1000

    Kapasitas penyimpanan untuk instans baru. Satuan: GB. Kapasitas penyimpanan bertambah dengan ukuran langkah 5 GB. Untuk informasi selengkapnya, lihat Tipe instans utama ApsaraDB RDS.

    Catatan Nilai default parameter ini adalah kapasitas penyimpanan dari instans utama.
    DbNames String Tidak test1,test2

    Nama database. Jika Anda menentukan lebih dari satu database, nilai parameter ini dalam format berikut: Original database name 1,Original database name 2.
    PayType String Tidak Postpaid

    Metode penagihan untuk instans baru. Nilai yang valid:

    • Postpaid: pay-as-you-go.
    • Prepaid: subscription.
    • Serverless: serverless. Nilai ini hanya didukung untuk instans yang menjalankan MySQL. Untuk informasi selengkapnya, lihat Ikhtisar.
    InstanceNetworkType String Tidak VPC

    Jenis jaringan untuk instans baru. Nilai yang valid:

    • VPC
    • Classic
    Catatan Nilai default parameter ini adalah jenis jaringan dari instans utama.
    DBInstanceId String Tidak rm-uf6wjk5xxxxxxxxxx

    ID instans.
    BackupId String Tidak 902****

    ID backup set.

    Anda dapat memanggil operasi DescribeBackups untuk mengambil daftar backup sets.

    Catatan Anda harus menentukan setidaknya salah satu dari parameter BackupId dan RestoreTime.
    RestoreTime String Tidak 2011-06-11T16:00:00Z

    Titik waktu untuk memulihkan data. Titik waktu tersebut harus berada dalam periode retensi backup yang ditentukan. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

    Catatan Anda harus menentukan setidaknya salah satu dari parameter BackupId dan RestoreTime.
    VPCId String Tidak vpc-uf6f7l4fg90xxxxxxxxxx

    ID virtual private cloud (VPC) tempat instans baru berada.

    Catatan VPC harus berada dalam wilayah yang ditentukan.
    VSwitchId String Tidak vsw-uf6adz52c2pxxxxxxxxxx

    ID vSwitch. vSwitch harus berada dalam zona yang ditentukan oleh parameter ZoneId.

    • Jika Anda menetapkan parameter InstanceNetworkType ke VPC, Anda juga harus menentukan parameter ini.
    • Jika Anda menentukan parameter ZoneSlaveId1, Anda harus menentukan ID dua vSwitch untuk parameter ini dan memisahkan ID tersebut dengan koma (,).
    PrivateIpAddress String Tidak 172.XX.XXX.69

    Alamat IP internal instans baru, yang harus berada dalam Blok CIDR yang didukung oleh vSwitch yang ditentukan. Sistem secara otomatis menetapkan alamat IP internal ke instans baru berdasarkan nilai parameter VPCId dan VSwitchId.
    UsedTime Integer Tidak 1

    Durasi langganan untuk instans baru.

    • Jika Anda menetapkan parameter Period ke Year, nilai parameter UsedTime berkisar antara 1 hingga 3.
    • Jika Anda menetapkan parameter Period ke Month, nilai parameter UsedTime berkisar antara 1 hingga 9.
    Catatan Jika Anda menetapkan parameter PayType ke Prepaid, Anda harus menentukan parameter UsedTime.
    Period String Tidak Year

    Unit yang digunakan untuk menghitung siklus penagihan instans baru. Nilai yang valid:

    • Year
    • Month
    Catatan Jika Anda menetapkan parameter PayType ke Prepaid, Anda harus menentukan parameter Period.
    Category String Tidak HighAvailability

    Edisi RDS untuk instans baru. Nilai yang valid:

    • Basic: RDS Basic Edition.
    • HighAvailability: RDS High-availability Edition.
    • AlwaysOn: RDS Cluster Edition untuk SQL Server.
    • cluster: RDS Cluster Edition untuk MySQL.
    • Finance: RDS Enterprise Edition. Edisi ini hanya tersedia di situs Tiongkok (aliyun.com).
    • serverless_basic: RDS Serverless Basic Edition.
    ZoneIdSlave1 String Tidak cn-hangzhou-c

    ID zona untuk instans secondary. Jika Anda menetapkan parameter ZoneIdSlave1 ke nilai yang sama dengan parameter ZoneId, metode penerapan single-zone digunakan. Jika Anda menetapkan parameter ZoneIdSlave1 ke nilai yang berbeda dari parameter ZoneId, metode penerapan multi-zone digunakan.
    ZoneIdSlave2 String Tidak cn-hangzhou-d

    ID zona untuk instans logger. Jika Anda menetapkan parameter ZoneIdSlave2 ke nilai yang sama dengan parameter ZoneId, metode penerapan single-zone digunakan. Jika Anda menetapkan parameter ZoneIdSlave2 ke nilai yang berbeda dari parameter ZoneId, metode penerapan multi-zone digunakan.
    DBInstanceStorageType String Tidak cloud_essd

    Tipe penyimpanan untuk instans baru. Nilai yang valid:

    • local_ssd: SSD lokal
    • cloud_ssd: SSD standar
    • cloud_essd: enhanced SSD (ESSD) tingkat kinerja 1 (PL1)
    • cloud_essd2: ESSD PL2
    • cloud_essd3: ESSD PL3
    RestoreTable String Tidak 1

    Menentukan apakah akan memulihkan database dan tabel yang Anda tentukan. Nilai 1 menunjukkan bahwa Anda ingin memulihkan database dan tabel yang ditentukan. Jika Anda tidak ingin memulihkan database atau tabel tertentu, jangan tentukan parameter ini.
    TableMeta String Tidak [{"type":"db","name":"testdb1","newname":"testdb1_new","tables":[{"type":"table","name":"testdb1table1","newname":"testdb1table1_new"}]}]

    Informasi tentang database dan tabel yang ingin Anda pulihkan. Sintaks:

    [{"type":"db","name":"The original name of Database 1","newname":"The new name of Database 1","tables":[{"type":"table","name":"The original name of Table 1 in Database 1","newname":"The new name of Table 1 in Database 1"},{"type":"table","name":"The original name of Table 2 in Database 1","newname":"The new name of Table 2 in Database 1"}]},{"type":"db","name":"The original name of Database 2","newname":"The new name of Database 2","tables":[{"type":"table","name":"The original name of Table 1 in Database 2","newname":"The new name of Table 1 in Database 2"},{"type":"table","name":"The original name of Table 2 in Database 2","newname":"The new name of Table 2 in Database 2"}]}]
    DedicatedHostGroupId String Tidak dhg-7a9xxxxxxxx

    ID klaster khusus tempat instans baru berada.
    BackupType String Tidak FullBackup

    Tipe backup. Nilai yang valid:

    • FullBackup
    • IncrementalBackup
    DeletionProtection Boolean Tidak true

    Menentukan apakah akan mengaktifkan fitur perlindungan rilis untuk instans baru. Nilai yang valid:

    • true: mengaktifkan fitur.
    • false: menonaktifkan fitur.

    Nilai default: false.
    AutoPause Boolean Tidak true

    Menentukan apakah akan mengaktifkan fitur mulai dan henti otomatis untuk instans serverless. Setelah fitur mulai dan henti otomatis diaktifkan, jika tidak ada koneksi ke instans dalam 10 menit, instans akan di-suspend. Setelah koneksi dibuat ke instans, instans akan dilanjutkan secara otomatis. Nilai yang valid:

    • true: mengaktifkan fitur.
    • false: menonaktifkan fitur. Ini adalah nilai default.
    MaxCapacity double Tidak 8

    Jumlah maksimum Unit Kapasitas RDS (RCU).
    MinCapacity double Tidak 0.5

    Jumlah minimum RCU.
    SwitchForce Boolean Tidak false

    Menentukan apakah akan mengaktifkan fitur penskalaan paksa untuk instans serverless. Secara umum, ApsaraDB RDS secara otomatis melakukan scaling in atau scaling out RCU instans serverless berdasarkan kebutuhan bisnis secara real time. Dalam kasus langka, scaling tidak berlaku secara real time. Anda dapat mengaktifkan fitur penskalaan paksa untuk memaksa scaling in atau scaling out RCU instans. Nilai yang valid:

    • true: mengaktifkan fitur.
    • false: menonaktifkan fitur. Ini adalah nilai default.

    Parameter respons

    Parameter Tipe Contoh Deskripsi
    DBInstanceId String rm-uf6wjk5xxxxxxx

    ID instans.
    RequestId String 1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC

    ID permintaan.
    OrderId String 100789370****

    ID pesanan.

    Contoh

    Contoh permintaan

    http(s)://rds.aliyuncs.com/?Action=CloneDBInstance
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-b
&DBInstanceClass=mysql.n1.micro.1
&DBInstanceStorage=1000
&DbNames=test1,test2
&PayType=Postpaid
&InstanceNetworkType=VPC
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&BackupId=902****
&RestoreTime=2011-06-11T16:00:00Z
&VPCId=vpc-uf6f7l4fg90xxxxxxxxxx
&VSwitchId=vsw-uf6adz52c2pxxxxxxxxxx
&PrivateIpAddress=172.XX.XXX.69
&UsedTime=1
&Period=Year
&Category=HighAvailability
&ZoneIdSlave1=cn-hangzhou-c
&ZoneIdSlave2=cn-hangzhou-d
&DBInstanceStorageType=cloud_essd
&RestoreTable=1
&TableMeta=[{"type":"db","name":"testdb1","newname":"testdb1_new","tables":[{"type":"table","name":"testdb1table1","newname":"testdb1table1_new"}]}]
&DedicatedHostGroupId=dhg-7a9xxxxxxxx
&BackupType=FullBackup
&DeletionProtection=true
&ServerlessConfig={"AutoPause":true,"MaxCapacity":8.0,"MinCapacity":0.5,"SwitchForce":false}
&Common request parameters

    Contoh respons sukses

    XML format

    HTTP/1.1 200 OK
Content-Type:application/xml

<CloneDBInstanceResponse>
    <DBInstanceId>rm-uf6wjk5xxxxxxx</DBInstanceId>
    <RequestId>1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC</RequestId>
    <OrderId>100789370****</OrderId>
</CloneDBInstanceResponse>

    JSON format

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "DBInstanceId" : "rm-uf6wjk5xxxxxxx",
  "RequestId" : "1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC",
  "OrderId" : "100789370****"
}

    Kode kesalahan

    Kode status HTTP Kode kesalahan Pesan kesalahan Deskripsi
    400 InvalidAvZone.Format Specified AvZone is not valid. Pesan kesalahan yang dikembalikan karena nilai parameter ZoneID tidak valid.
    400 InvalidAvZone.NotSupport Specified availableArea multiZone does not support in RDS. Pesan kesalahan yang dikembalikan karena nilai yang ditentukan untuk parameter availableArea multiZone tidak didukung di ApsaraDB RDS.
    400 CannotDecreaseEssdPerfLevel cannot decrease cloud essd performance level. Pesan kesalahan yang dikembalikan karena perubahan tipe penyimpanan tidak diizinkan. Tipe penyimpanan instans yang menjalankan SQL Server dengan SSD standar hanya dapat diubah menjadi ESSD. Tipe penyimpanan instans yang menjalankan SQL Server dengan SSD lokal dapat diubah menjadi SSD standar atau ESSD.
    400 CannotDecreaseEssdPerfLevel invalid cloud essd storage size. Pesan kesalahan yang dikembalikan karena nilai parameter DBInstanceStorage tidak valid.
    400 InvalidIPAddress.Conflict IP address conflict. Pesan kesalahan yang dikembalikan karena konflik alamat IP.
    400 CDDC.AvailableHostsNotEnoughInZone Not enough available hosts are in the target zone. Pesan kesalahan yang dikembalikan karena tidak ada host yang tersedia di zona yang ditentukan. Buat host di zona tersebut dan coba lagi.
    400 InvalidInstanceLevel.DiskType Specified instance level not support request disk type Pesan kesalahan yang dikembalikan karena tipe instans yang ditentukan tidak mendukung tipe penyimpanan yang ditentukan.
    400 InvalidRecoveryDbInstance.StorageType The disk local_ssd can not clone to cloud disk type Pesan kesalahan yang dikembalikan karena Anda tidak dapat memulihkan data dari instans yang menggunakan SSD lokal ke instans yang menggunakan SSD standar atau ESSD.
    400 InvalidRecoveryDbInstance.StorageSize The disk space of the new instance cannot be less than that of the current instance Pesan kesalahan yang dikembalikan karena kapasitas penyimpanan instans baru harus lebih besar dari atau sama dengan ukuran total data yang disimpan di instans asli.
    403 IncorrectMinorVersion Current engine minor version does not support operations. Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk versi minor mesin saat ini.
    403 IncorrectCharacterType Current DB instance character type does not support this operation. Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk tipe karakter instans saat ini.

    Untuk daftar kode kesalahan, lihat Kode Kesalahan Layanan.