All Products
Search

This Product

    :Migrasi instans antar zona

    Document Center

    :Migrasi instans antar zona

    Last Updated:May 27, 2026

    Anda dapat memanggil operasi MigrateToOtherZone untuk melakukan migrasi instans antar zona.

    Prasyarat untuk operasi ini bervariasi tergantung pada mesin database instans tersebut. Untuk informasi selengkapnya, lihat topik berikut:

    Catatan Operasi ini hanya memungkinkan migrasi instans antar zona dalam wilayah yang sama. Misalnya, Anda tidak dapat memindahkan instans dari zona di wilayah China (Hangzhou) ke zona di wilayah China (Qingdao).

    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

    ParameterTypeWajibContohDeskripsi
    ActionStringYaMigrateToOtherZone

    Operasi yang ingin Anda lakukan. Tetapkan nilai ke MigrateToOtherZone.

    DBInstanceIdStringYarm-uf6wjk5xxxxxxxxxx

    ID instans. Anda dapat memanggil operasi DescribeDBInstances untuk mengkueri ID instans tersebut.

    VPCIdStringTidakvpc-xxxxxxx

    ID dari virtual private cloud (VPC) tempat instans berada. Jangan mengubah VPC instans tersebut.

    • Parameter ini harus ditentukan ketika instans berada dalam VPC.
    • Jika instans menjalankan SQL Server, Anda dapat mengubah VPC instans tersebut.
    ZoneIdStringYacn-hangzhou-b

    ID zona tujuan. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID zona tersebut.

    EffectiveTimeStringTidakImmediate

    Waktu saat Anda ingin perubahan diterapkan. Nilai yang valid:

    • Immediately: Perubahan langsung diterapkan. Ini adalah nilai default.
    • MaintainTime: Perubahan diterapkan selama jendela maintenance yang ditentukan. Untuk informasi selengkapnya, lihat ModifyDBInstanceMaintainTime.
    • ScheduleTime: Perubahan diterapkan pada waktu tertentu yang Anda tentukan.
    Catatan Jika Anda mengatur parameter ini ke ScheduleTime, Anda harus menentukan parameter SwitchTime.
    VSwitchIdStringTidakvsw-uf6adz52c2pxxxxxxx

    ID vSwitch dari instans.

    • Parameter ini harus ditentukan ketika instans berada di dalam VPC. Anda dapat memanggil operasi DescribeVSwitches untuk mengkueri ID vSwitch.
    • Jika instans menjalankan PostgreSQL atau SQL Server dan zona secondary ditentukan untuk instans tersebut, Anda dapat menentukan multiple ID vSwitch, masing-masing sesuai dengan satu zona. Pisahkan ID vSwitch tersebut dengan koma (,).
    CategoryStringTidakHighAvailability

    Edisi RDS dari instans. Nilai yang valid:

    • Basic: RDS Basic Edition
    • HighAvailability: RDS High-availability Edition
    • AlwaysOn: RDS Cluster Edition
    • Finance: RDS Enterprise Edition
    ZoneIdSlave1StringTidakcn-hangzhou-c

    Zona dari instans secondary.

    Catatan Anda harus menentukan parameter ini ketika instans tidak menjalankan RDS Basic Edition.
    ZoneIdSlave2StringTidakcn-hangzhou-d

    Zona instans logger.

    Catatan Anda hanya dapat menentukan parameter ini ketika instans menjalankan RDS Enterprise Edition.
    SwitchTimeStringTidak2021-12-14T15:15:15Z

    Waktu saat Anda ingin perubahan diterapkan. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu tersebut harus dalam UTC.

    Catatan Parameter ini digunakan bersama parameter EffectiveTime. Anda hanya boleh menentukan parameter ini jika parameter EffectiveTime diatur ke ScheduleTime.
    IsModifySpecStringTidaktrue

    Menentukan apakah akan mengubah spesifikasi instans selama migrasi. Nilai yang valid:

    • true: mengubah spesifikasi instans selama migrasi. Jika Anda mengatur parameter ini ke true, Anda harus menentukan setidaknya salah satu dari parameter DBInstanceClass dan DBInstanceStorage.
    • false: tidak mengubah spesifikasi instans selama migrasi. Ini adalah nilai default.
    Catatan Parameter ini hanya berlaku untuk instans yang menjalankan MySQL.
    DBInstanceClassStringTidakmysql.x4.xlarge.2

    Tipe instans baru dari instans tersebut. Anda dapat mengubah tipe instans instans tersebut. Anda tidak dapat mengubah tipe penyimpanan instans tersebut.

    Jika Anda menetapkan parameter IsModifySpec ke true, Anda harus menentukan setidaknya salah satu dari parameter DBInstanceClass dan DBInstanceStorage.

    Untuk informasi selengkapnya tentang tipe instans, lihat Tipe instans utama ApsaraDB RDS for MySQL.

    DBInstanceStorageLongTidak500

    Kapasitas penyimpanan baru dari instans tersebut. Jika Anda mengatur parameter IsModifySpec ke nilai true, Anda harus menentukan setidaknya salah satu dari parameter DBInstanceStorage dan DBInstanceClass.

    Unit: GB.

    Rentang kapasitas penyimpanan yang tersedia bervariasi tergantung pada tipe instans dari instans tersebut. Untuk informasi selengkapnya, lihat Tipe instans utama ApsaraDB RDS for MySQL.

    Parameter respons

    ParameterTypeContohDeskripsi
    RequestIdString65BDA532-28AF-4122-AA39-B382721EEE64

    ID dari permintaan tersebut.

    DBInstanceIdStringrm-uf6wjk5xxxxxxxxxx

    ID instans.

    OrderIdLong213341575990728

    ID pesanan. Parameter ini hanya dikembalikan ketika instans menjalankan MySQL.

    Contoh

    Permintaan contoh

    Respons sukses contoh

    JSON format

    HTTP/1.1 200 OK

    Kode kesalahan

    Kode status HTTPKode kesalahanPesan kesalahanDeskripsi
    400RenewChange.ExistThe Current InstanceId existed renewChange order in RDS.Pesan kesalahan dikembalikan karena spesifikasi instans sedang diubah. Tunggu hingga perubahan selesai dan coba lagi.
    400InvalidMigrateModifyClassOrStorageSpecified parameter DBInstanceClass or Storage is invalid.Pesan kesalahan yang dikembalikan karena nilai parameter DBInstanceClass atau parameter DBInstanceStorage tidak valid.
    400EngineNotSupportedEngine specified cannot be supported the operation.Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk mesin database yang dijalankan oleh Instans. Perbarui versi mesin minor Instans dan coba lagi.
    400IncorrectDBInstanceLockMode.ValueNotSupportedThe Current DB instance lock mode does not support this operation.Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat instans berada dalam mode kunci.
    400InvalidZoneId.NotNullThe parameter ZoneId must not be null or autoPesan kesalahan yang dikembalikan karena nilai parameter ZoneId adalah null atau auto.
    400InvalidZoneId.NotEqualThe parameter ZoneId is the same as the previous onePesan kesalahan yang dikembalikan karena zona tujuan sama dengan zona sumber.
    400IncorrectDBInstanceTypeCurrent DB instance type does not support this operation.Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat instans berada dalam status saat ini.
    400InsufficientResourceCapacityCheckThere is insufficient capacity available for the requested instance with precheck.Pesan kesalahan yang dikembalikan karena instans yang ditentukan tidak memiliki penyimpanan yang cukup dan gagal dalam dry run.
    400SSLInstanceNotSupportThisOperationThe instance opened SSL, upgrade is not this operationPesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk instans yang telah mengaktifkan fitur enkripsi SSL.
    400BYOLInstanceNotSupportThisOperationThe BYOL instance is not supported this operationPesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk instans yang menggunakan Gunakan Lisensi Sendiri (BYOL).
    400BYOKInstanceNotSupportThisOperationThe BYOK instance is not supported this operationPesan kesalahan yang dikembalikan karena operasi tidak didukung untuk instans yang enkripsi disk-nya diaktifkan.
    400ADInstanceNotSupportThisOperationThe AD instance is not supported this operationPesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk instans yang ditambahkan ke domain Active Directory (AD).
    400TDEInstanceNotSupportThisOperationThe instance opened TDE, this operation is not supportedPesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk instans yang memiliki fitur Enkripsi Data Transparan (TDE) diaktifkan.
    400InstanceIsSnapshotBackupNotSupportThisOperationThe instance backup method is snapshot backup, this operation is not supportedPesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk instans yang memiliki fitur cadangan snapshot diaktifkan.
    400InstanceHasReadOnlyInstanceNotSupportThisOperationThe instance has read-only instance or is read-only instance, this operation is not supportedPesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk Instansi hanya baca atau instansi yang disambungkan dengan Instansi hanya baca.
    400VswitchIpExhaustedNo available ip in the specified vswitch.Pesan kesalahan yang dikembalikan karena vSwitch yang ditentukan tidak memiliki alamat IP yang tersedia.
    400OperationDenied.MasterDBInstanceStateThe operation is not permitted due to status of master instance.Pesan kesalahan yang dikembalikan karena konfigurasi Instansi hanya baca sedang diubah. Dalam hal ini, Anda tidak dapat melakukan operasi ini pada Instans utama. Tunggu hingga konfigurasi Instansi hanya baca selesai diubah, lalu coba lagi.
    400InvalidShareInstance.NotSupportThe share dbInstance is not support.Pesan kesalahan yang dikembalikan karena instans bersama tidak didukung.
    400InvalidZoneIdSlave1.MissingThe parameter ZoneIdSlave1 must be specified.Pesan kesalahan yang dikembalikan karena ID zona instans sekunder kosong.
    400MigrateAlreadyExistsFaultThe rds instance already has a given vpc migrate task.Pesan kesalahan yang dikembalikan karena tugas migrasi VPC telah dibuat untuk Instans tersebut.
    400InvalidInstanceKind.NotSupportThe instance kind does not support this operation.Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung oleh konfigurasi instans.
    400MissingCategoryThe instance is missing a category parameter.Pesan kesalahan yang dikembalikan karena parameter Category tidak ditentukan untuk instans.
    400InvalidInstanceNodeType.NotFoundThe specified NodeType is not found.Pesan kesalahan yang dikembalikan karena parameter NodeType tidak ditentukan. Tentukan parameter tersebut.
    400EngineVersionNotSupportedEngineVersion specified cannot be replicate with the source DB Instance.Pesan kesalahan yang dikembalikan karena versi mesin database tidak mendukung kloning instans.
    400CommodityCodeNotFoundCommodityCodeNotFoundPesan kesalahan yang dikembalikan karena nilai parameter CommodityCode tidak valid. Masukkan nilai yang valid dan coba lagi.
    403OperationDenied.OutofUsageThe resource is out of usage.Pesan kesalahan yang dikembalikan karena zona yang ditentukan tidak menyediakan sumber daya yang cukup. Anda harus memilih zona lain.
    403IncorrectEffectiveTimeThe specified EffectiveTime params is not valid.Pesan kesalahan yang dikembalikan karena nilai parameter EffectiveTime tidak valid.
    403InvalidTempInstance.NotSupportThe temp db Instance is not support.Pesan kesalahan yang dikembalikan karena Instans terkunci.
    403OperationDenied.LockModeThe operation is not permitted due to instance being locked.Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat instance terkunci. Periksa apakah kapasitas penyimpanan instance telah habis atau apakah instance kedaluwarsa. Jika kapasitas penyimpanan instance telah habis, ubah spesifikasi instance untuk memperluas kapasitas penyimpanan, tunggu hingga instance tidak terkunci lagi, lalu coba lagi. Jika instance kedaluwarsa, lakukan perpanjangan instance, tunggu hingga instance tidak terkunci lagi, lalu coba lagi.
    403ClassicNetworkType.NotSupportThe Classic instance network create is not support.Pesan kesalahan yang dikembalikan karena Instans jenis jaringan klasik tidak dapat dibuat. Buatlah Instans jenis jaringan lainnya.
    403InstanceNetworkTypeNotFoundFaultThe specified DBInstanceNetworkType is not found.Pesan kesalahan yang dikembalikan karena instans gagal dalam pemeriksaan jenis jaringan. Jenis jaringan dari instans tersebut tidak ada.
    403ProprietaryCloud.NotSupportedThe proprietary cloud not supported.Pesan kesalahan yang dikembalikan karena Apsara Stack tidak didukung.
    403MigrateAlreadyReadWriteSplitExistsFaultThe rds instance already has a given vpc migrate task.Pesan kesalahan yang dikembalikan karena tugas migrasi VPC telah dibuat untuk Instans tersebut.
    403InvalidRegionAvzNotFoundSpecified user does not find the region and avz.Pesan kesalahan yang dikembalikan karena pengguna yang ditentukan tidak dapat menemukan wilayah atau zona instans.
    403ZoneIdNotSupportedThe zone ID is not supported.Pesan kesalahan yang dikembalikan karena zona yang ditentukan oleh parameter ZoneId tidak didukung.
    403InvalidVpcInfo.NotFoundSpecified VPC info does not exist.Pesan kesalahan yang dikembalikan karena VPC yang ditentukan tidak ada.
    404InvalidDBInstanceName.NotFoundThe database instance does not exist.Pesan kesalahan yang dikembalikan karena nama Instans tidak dapat ditemukan. Periksa apakah nama tersebut benar.
    404IncorrectVswitchIdThe specified parameter VSwitchId is not valid.Pesan kesalahan yang dikembalikan karena nilai parameter VSwitchId tidak valid.

    Untuk daftar kode kesalahan, lihat Service error codes.