All Products
Search

This Product

    :Pulihkan data ke instans baru lintas wilayah

    Document Center

    :Pulihkan data ke instans baru lintas wilayah

    Last Updated:May 27, 2026

    Anda dapat memanggil operasi CreateDdrInstance untuk memulihkan data dari suatu instans ke instans baru di wilayah berbeda.

    Sebelum memanggil operasi ini, Anda dapat menggunakan operasi CheckCreateDdrDBInstance untuk memverifikasi apakah data instans sumber dapat dipulihkan dari file backup lintas wilayah.

    Pastikan instans menjalankan salah satu mesin database berikut sebelum memanggil operasi ini:

    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 untuk berbagai SDK.

    Parameter permintaan

    Parameter Tipe Wajib Contoh Deskripsi
    Action String Yes CreateDdrInstance

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CreateDdrInstance.

    RegionId String Yes cn-hangzhou

    ID wilayah instans tujuan. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.

    Engine String Yes MySQL

    Mesin database instans tujuan. Nilai yang valid:

    • MySQL
    • SQLServer
    • PostgreSQL
    EngineVersion String Yes 5.6

    Versi mesin utama instans tujuan. Nilai parameter ini bervariasi berdasarkan nilai parameter Engine. Nilai yang valid:

    • Nilai yang valid saat Anda menetapkan parameter Engine ke MySQL: 5.5, 5.6, 5.7, dan 8.0
    • Nilai yang valid saat Anda menetapkan parameter Engine ke SQL Server: 2008r2, 08r2_ent_ha, 2012, 2012_ent_ha, 2012_std_ha, 2012_web, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_std_ha, 2017_ent, 2019_std_ha, dan 2019_ent
    • Nilai yang valid saat Anda menetapkan parameter Engine ke PostgreSQL: 9.4, 10.0, 11.0, 12.0, dan 13.0
    DBInstanceClass String Yes rds.mysql.s1.small

    Tipe instans instans tujuan. Untuk informasi selengkapnya, lihat Tipe instans ApsaraDB RDS utama.

    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 Tipe instans ApsaraDB RDS utama.

    SystemDBCharset String No uft8

    Set karakter instans tujuan. Nilai yang valid:

    • utf8
    • gbk
    • latin1
    • utf8mb4
    DBInstanceNetType String Yes Intranet

    Jenis koneksi jaringan instans tujuan. Nilai yang valid:

    • Internet: Internet
    • Intranet: jaringan internal
    DBInstanceDescription String No testdatabase

    Nama instans tujuan. Nama harus terdiri dari 2 hingga 256 karakter dan dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Nama harus dimulai dengan huruf.

    Catatan Nama tidak boleh dimulai dengan http:// atau https://.
    SecurityIPList String Yes 127.0.0.1

    Daftar putih alamat IP instans tujuan. Jika Anda ingin menambahkan lebih dari satu entri ke daftar putih alamat IP, pisahkan entri tersebut dengan koma (,). Setiap entri harus unik. Anda dapat menambahkan maksimal 1.000 entri. Untuk informasi selengkapnya, lihat Konfigurasi daftar putih alamat IP untuk instans ApsaraDB RDS for MySQL. Entri dalam daftar putih alamat IP harus dalam salah satu format berikut:

    • Alamat IP. Contoh: 10.23.12.24.
    • Blok CIDR. Contoh: 10.23.12.24/24. Dalam contoh ini, 24 menunjukkan bahwa awalan blok CIDR memiliki panjang 24 bit. Anda dapat mengganti 24 dengan nilai antara 1 hingga 32.
    ClientToken String No ETnLKlblzczshOTUbOCzxxxxxxxxxx

    Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan client untuk menghasilkan token, tetapi Anda harus memastikan bahwa token yang dihasilkan bersifat unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan tidak boleh melebihi 64 karakter.

    PayType String Yes Prepaid

    Metode penagihan instans tujuan. Nilai yang valid:

    • Postpaid: pay-as-you-go
    • Prepaid: subscription
    ZoneId String No cn-hangzhou-b

    ID zona instans tujuan. Jika instans tujuan ditempatkan di beberapa zona, pisahkan ID zona tersebut dengan titik dua (:).

    Catatan Jika Anda menentukan virtual private cloud (VPC) dan vSwitch, Anda juga harus menentukan parameter ZoneId.
    InstanceNetworkType String No Classic

    Jenis jaringan instans tujuan. Nilai yang valid:

    • VPC
    • Classic

    Nilai default: Classic.

    Catatan Jika Anda menetapkan parameter ini ke VPC, Anda juga harus menentukan parameter VPCId dan VSwitchId.
    ConnectionMode String No Standard

    Mode koneksi instans tujuan. Nilai yang valid:

    • Standard: mode standar
    • Safe: mode proksi database

    Nilai default: Standard

    VPCId String No vpc-xxxxxxxxxxxx

    ID VPC instans tujuan. Parameter ini tersedia hanya jika Anda menetapkan parameter InstanceNetworkType ke VPC.

    Catatan Jika Anda menentukan parameter ini, Anda juga harus menentukan parameter ZoneId.
    VSwitchId String No vsw-xxxxxxxxxxx

    ID vSwitch instans tujuan. Jika Anda menentukan lebih dari satu vSwitch, pisahkan ID vSwitch tersebut dengan koma (,). Parameter ini tersedia hanya jika Anda menetapkan parameter InstanceNetworkType ke VPC.

    Catatan Jika Anda menentukan parameter ini, Anda juga harus menentukan parameter ZoneId.
    PrivateIpAddress String No 172.XXX.XXX.69

    Alamat IP pribadi instans tujuan. Alamat IP pribadi harus berada dalam blok CIDR yang didukung oleh vSwitch yang ditentukan. Sistem secara otomatis menetapkan alamat IP pribadi ke instans berdasarkan nilai parameter VPCId dan VSwitchId.

    UsedTime String No 2

    Durasi langganan instans. Nilai yang valid:

    • 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 juga harus menentukan parameter ini.
    Period String No Year

    Unit yang digunakan untuk mengukur durasi langganan instans tujuan. Nilai yang valid:

    • Year
    • Month
    Catatan Jika Anda menetapkan parameter PayType ke Prepaid, Anda juga harus menentukan parameter ini.
    ResourceGroupId String No rg-acfmyxxxxxxxxxx

    ID kelompok sumber daya.

    RestoreType String Yes BackupSet

    Metode yang digunakan untuk memulihkan data. Nilai yang valid:

    • BackupSet: Data dipulihkan dari set cadangan. Jika Anda menggunakan nilai ini, Anda juga harus menentukan parameter BackupSetID.
    • BackupTime: memulihkan data ke titik waktu tertentu. Anda juga harus menentukan parameter RestoreTime, SourceRegion, dan SourceDBInstanceName.
    BackupSetId String No 14***

    ID set cadangan yang digunakan untuk pemulihan. Anda dapat memanggil operasi DescribeCrossRegionBackups untuk mengambil ID set cadangan.

    Catatan Jika Anda menetapkan parameter RestoreType ke BackupSet, 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 BackupTime, 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 BackupTime, 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 BackupTime, Anda juga harus menentukan parameter ini.
    DBInstanceStorageType String No local_ssd

    Jenis penyimpanan instans tujuan. Hanya jenis penyimpanan SSD lokal yang didukung. Nilai default: local_ssd.

    Parameter respons

    Parameter Tipe Contoh Deskripsi
    DBInstanceId String rm-xxxxx

    ID instans tujuan.

    RequestId String E52666CC-330E-418A-8E5B-A19E3FB42D13

    ID permintaan.

    Port String 3306

    Nomor port yang digunakan untuk menghubungkan ke instans tujuan.

    Catatan Parameter DBInstanceNetType menunjukkan apakah port tersebut merupakan port internal atau port publik.
    ConnectionString String rm-xxxxx.mysql.rds.aliyuncs.com

    Titik akhir yang digunakan untuk menghubungkan ke instans tujuan.

    Catatan Parameter DBInstanceNetType menunjukkan apakah titik akhir tersebut merupakan titik akhir internal atau titik akhir publik.
    OrderId String 2038691xxxxx

    ID pesanan.

    Contoh

    Permintaan contoh

    http(s)://rds.aliyuncs.com/?Action=CreateDdrInstance
&RegionId=cn-hangzhou
&Engine=MySQL
&EngineVersion=5.6
&DBInstanceClass=rds.mysql.s1.small
&DBInstanceStorage=20
&SystemDBCharset=uft8
&DBInstanceNetType=Intranet
&DBInstanceDescription=testdatabase
&SecurityIPList=127.0.0.1
&ClientToken=ETnLKlblzczshOTUbOCzxxxxxxxxxx
&PayType=Prepaid
&ZoneId=cn-hangzhou-b
&InstanceNetworkType=Classic
&ConnectionMode=Standard
&VPCId=vpc-xxxxxxxxxxxx
&VSwitchId=vsw-xxxxxxxxxxx
&PrivateIpAddress=172.XXX.XXX.69
&UsedTime=2
&Period=Year
&ResourceGroupId=rg-acfmyxxxxxxxxxx	
&RestoreType=BackupSet
&BackupSetId=14***
&RestoreTime=2019-05-30T03:29:10Z
&SourceRegion=cn-hangzhou
&SourceDBInstanceName=rm-uf6wjk5xxxxxxx
&DBInstanceStorageType=local_ssd
&Common request parameters

    Respons sukses contoh

    XML format

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

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

    JSON format

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

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

    Kode kesalahan

    Kode status HTTP Kode kesalahan Pesan kesalahan Deskripsi
    400 InvalidZoneId.NotSupported The Specified vpc Zone not supported. Pesan kesalahan yang dikembalikan karena zona yang ditentukan tidak mengizinkan Anda membuat instans di VPC. Tentukan zona lain dan coba lagi.
    400 InvalidDBInstanceName.Format Specified DB instance name is not valid. Pesan kesalahan yang dikembalikan karena instans tidak ada. Periksa informasi instans.
    400 InvalidDBInstanceName.Duplicate Specified DB instance name already exists in the Aliyun RDS. Pesan kesalahan yang dikembalikan karena nama instans sudah ada. Tentukan nama lain dan coba lagi.
    400 InvalidRegion.Format Specified Region is not valid. Pesan kesalahan yang dikembalikan karena wilayah yang ditentukan tidak valid.
    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 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 InvalidConnectionString.Format Specified connection string is not valid. Pesan kesalahan yang dikembalikan karena awalan titik akhir tidak valid. Awalan harus terdiri dari 5 hingga 40 karakter.
    400 InvalidConnectionString.Duplicate Specified connection string already exists in the Aliyun RDS. Pesan kesalahan yang dikembalikan karena titik akhir yang Anda tentukan sudah ada. Tentukan titik akhir lain.
    400 InvalidCharacterSetName.Format Specified character set name is not valid. Pesan kesalahan yang dikembalikan karena set karakter yang ditentukan tidak valid. ApsaraDB RDS mendukung set karakter berikut: GBK, UTF-8, EUC-KR, dan ASCII.
    400 InvalidDBInstanceType.Format Specified instance type is not valid. Pesan kesalahan yang dikembalikan karena tipe instans yang ditentukan tidak valid. Tentukan tipe instans yang valid.
    400 InvalidPort.Malformed Specified port is not valid. Pesan kesalahan yang dikembalikan karena nomor port yang Anda tentukan tidak valid.
    400 InvalidBackupRetentionPeriod.Malformed Specified backup retention period is not valid. Pesan kesalahan yang dikembalikan karena siklus backup yang ditentukan tidak valid. Siklus backup harus lebih dari 1 hari atau kurang dari atau sama dengan 30 hari.
    400 InvalidPreferredBackupTime.Format Specified preferred backup time is not valid. Pesan kesalahan yang dikembalikan karena format waktu backup salah. Tentukan waktu dalam GMT dengan format YYYY-MM-DDThh:mmZ. Contoh: 2012-06-11T15:00Z.
    400 InvalidPreferredBackupPeriod.Malformed Specified backup period is not valid. Pesan kesalahan yang dikembalikan karena waktu backup tidak valid.
    400 InvalidExpiredTime.Format Specified expired time is not valid. Pesan kesalahan yang dikembalikan karena nilai parameter ExpiredTime tidak valid. Tentukan waktu dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.
    400 InvalidSecurityIPList.Format Specified security IP list format is not valid. Pesan kesalahan yang dikembalikan karena daftar putih alamat IP tidak valid. Periksa daftar putih alamat IP.
    400 InvalidSecurityIPList.Duplicate Specified security IP list is not valid: Duplicate IP address in the list Pesan kesalahan yang dikembalikan karena alamat IP atau blok CIDR yang ditentukan tidak valid. Alamat IP atau blok CIDR yang ditentukan duplikat.
    400 InvalidSecurityIPList.QuotaExceeded Specified security IP list is not valid: Exceeding the allowed amount of IP address in the list. Pesan kesalahan yang dikembalikan karena jumlah entri dalam daftar putih alamat IP yang ditentukan melebihi batas atas. Anda dapat menentukan maksimal 1.000 entri untuk daftar putih alamat IP.
    400 InvalidDBInstanceDescription.Format Specified DB instance description is not valid. Pesan kesalahan yang dikembalikan karena nilai parameter DBInstanceDescription tidak valid. Tentukan nilai yang valid untuk parameter ini. Nilai parameter ini harus terdiri dari 2 hingga 256 karakter dan dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Nilai harus dimulai dengan huruf.
    400 InvalidStorage.Format Specified Storage is not valid. Pesan kesalahan yang dikembalikan karena nilai parameter Storage tidak valid. Tentukan nilai yang valid untuk parameter ini.
    400 InvalidDBInstanceConnType.Format Specified DB instance conn type is not valid. Pesan kesalahan yang dikembalikan karena jenis jaringan instans tidak mendukung operasi ini.
    400 PreCheckInvalid CreateDdrInstance PreCheck Is Invalid Pesan kesalahan yang dikembalikan karena pemeriksaan awal untuk operasi CreateDdrInstance tidak valid.
    400 IncorrectDBInstanceType Current DB instance engine and type does not support operations. Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk mesin database dan tipe instans 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 backup tidak ada.
    400 NoBaksetName BaksetName is absence. Pesan kesalahan yang dikembalikan karena nama set backup tidak ada.
    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 backup yang tersedia.
    400 InvalidBackupType.Format Specified backup type is not valid. Pesan kesalahan yang dikembalikan karena tipe backup tidak valid.
    400 IncorrectEngineVersion Current engine version does not support operations. Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk versi mesin database yang dijalankan pada instans.
    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.
    403 IncorrectBackupSetMethod Current backup set method does not support operations. Pesan kesalahan yang dikembalikan karena set backup yang ditentukan tidak dapat digunakan untuk memulihkan database dan tabel individual.
    403 IncorrectBaksetVersion Current bakset version does not support operations. Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk versi set backup.
    403 CrossRegionUnsupportTDE Cross-region disaster restore not support TDE bakset. Pesan kesalahan yang dikembalikan karena set backup berbasis TDE tidak dapat digunakan untuk memulihkan instans ke wilayah lain.
    404 InvalidRegion.NotFound Specified Region does not exist in the RDS Pesan kesalahan yang dikembalikan karena ID wilayah tidak valid.
    404 InvalidClusterName.NotFound The specified cluster name is not available. Pesan kesalahan yang dikembalikan karena nama kluster tidak ada. Periksa nama kluster dan coba lagi.
    404 InvalidDBInstanceClass.NotFound Specified DB instance class is not found. Pesan kesalahan yang dikembalikan karena tipe instans baru tidak dapat ditemukan atau tidak lagi tersedia untuk pembelian. Pilih tipe instans yang tersedia.
    404 InvalidDBInstanceNetType.NotFound Specified DB instance net type is not found. Pesan kesalahan yang dikembalikan karena jenis jaringan instans tidak valid. Periksa jenis jaringan.
    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 backup yang ditentukan tidak ada. Anda harus memeriksa set backup yang ada.

    Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.