All Products
Search

This Product

    ApsaraDB RDS:MigrateToOtherZone

    Document Center

    ApsaraDB RDS:MigrateToOtherZone

    Last Updated:Jun 12, 2026

    Memigrasi instans RDS ke zona yang berbeda.

    Deskripsi operasi

    Mesin database yang didukung

    • RDS MySQL

    • RDS PostgreSQL

    • RDS SQL Server.

    Dokumen terkait

    Penting Sebelum memanggil operasi ini, baca dokumen terkait dengan saksama untuk memastikan Anda sepenuhnya memahami prasyarat dan dampak pemanggilan operasi ini.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    DBInstanceId

    string

    Yes

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

    rm-uf6wjk5****
    VPCId

    string

    No

    ID virtual private cloud (VPC). VPC tidak dapat diubah saat Anda memigrasi instans lintas zona. Anda harus menentukan VPC asli.

    • Parameter ini diperlukan saat Anda memigrasi instans yang berada di VPC lintas zona.

    • Jika instans menjalankan SQL Server, Anda dapat mengubah VPC saat memigrasi instans lintas zona.

    vpc-****
    ZoneId

    string

    Yes

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

    cn-hangzhou-b
    EffectiveTime

    string

    No

    Pengatur waktu saat Anda ingin perubahan diterapkan. Nilai valid:

    • Immediate: Nilai default. Perubahan langsung diterapkan.

    • MaintainTime: Perubahan diterapkan selama jendela pemeliharaan instans. Untuk informasi selengkapnya, lihat ModifyDBInstanceMaintainTime.

    • ScheduleTime: Perubahan diterapkan pada pengatur waktu yang Anda tentukan.

    Catatan

    Jika Anda menetapkan parameter ini ke ScheduleTime, Anda juga harus menentukan parameter SwitchTime.

    Immediate
    VSwitchId

    string

    No

    ID vSwitch.

    • Parameter ini diperlukan saat Anda memigrasi instans yang berada di VPC lintas zona. Anda dapat memanggil operasi DescribeVSwitches untuk mengkueri vSwitch yang telah dibuat.

    • Saat instans RDS PostgreSQL atau SQL Server dimigrasi lintas zona dengan zona sekunder yang dikonfigurasi, Anda dapat menentukan beberapa ID vSwitch yang dipisahkan koma (,), masing-masing sesuai dengan satu zona.

    vsw-uf6adz52c2p****
    Category

    string

    No

    Edisi instans RDS. Nilai valid:

    • Basic: Edisi Dasar

    • HighAvailability: Edisi Ketersediaan Tinggi

    • AlwaysOn: Edisi Kluster untuk SQL Server

    • cluster: Edisi Kluster untuk MySQL

    • Finance: Edisi Perusahaan (tiga node).

    HighAvailability
    ZoneIdSlave1

    string

    No

    ID zona sekunder 1.

    Catatan

    Parameter ini diperlukan untuk instans yang tidak menggunakan Edisi Dasar.

    cn-hangzhou-c
    ZoneIdSlave2

    string

    No

    ID zona sekunder 2.

    Catatan

    Parameter ini hanya dapat ditentukan untuk instans yang menggunakan Edisi Perusahaan (tiga node).

    cn-hangzhou-d
    SwitchTime

    string

    No

    Pengatur waktu khusus saat zona diubah. format: yyyy-MM-ddTHH:mm:ssZ (pengatur waktu UTC).

    Catatan

    Parameter ini digunakan bersama parameter EffectiveTime. Parameter ini hanya diperlukan saat EffectiveTime ditetapkan ke ScheduleTime.

    2021-12-14T15:15:15Z
    IsModifySpec

    string

    No

    Apakah akan mengubah spesifikasi instans saat Anda memigrasi instans lintas zona.

    • true: Mengubah spesifikasi. Jika Anda menetapkan parameter ini ke true, Anda harus menentukan setidaknya satu dari parameter DBInstanceClass dan DBInstanceStorage.

    • false: Nilai default. Tidak mengubah spesifikasi.

    Catatan

    Parameter ini hanya didukung oleh instans RDS MySQL.

    true
    DBInstanceClass

    string

    No

    Tipe instans tujuan. Hanya pengubahan tipe instans yang didukung, bukan pengubahan tipe penyimpanan. Saat IsModifySpec ditetapkan ke true, Anda harus menentukan setidaknya satu dari parameter ini dan DBInstanceStorage.

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

    mysql.x4.xlarge.2
    DBInstanceStorage

    integer

    No

    Kapasitas penyimpanan tujuan. Saat IsModifySpec ditetapkan ke true, Anda harus menentukan setidaknya satu dari parameter ini dan DBInstanceClass.

    Unit: GB. Rentang valid: Kapasitas penyimpanan yang dapat Anda perluas bervariasi berdasarkan tipe instans. Untuk informasi selengkapnya, lihat Tipe instans utama ApsaraDB RDS.

    500
    IoAccelerationEnabled

    string

    No

    Apakah akan mengaktifkan fitur Buffer Pool Extension (BPE) untuk SSD Enhanced. Nilai valid:

    • 1: Mengaktifkan fitur.

    • 0: Menonaktifkan fitur.

    Catatan

    Untuk informasi selengkapnya tentang fitur Buffer Pool Extension (BPE), lihat Buffer Pool Extension (BPE).

    0
    DBInstanceStorageType

    string

    No

    Tipe penyimpanan instans. Nilai valid:

    • cloud_essd: ESSD PL1.

    • cloud_essd2: ESSD PL2.

    • cloud_essd3: ESSD PL3.

    • cloud_ssd: SSD standar (tidak direkomendasikan; penjualan telah dihentikan di beberapa wilayah).

    cloud_essd
    CustomExtraInfo

    string

    No

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Detail parameter tanggapan.

    DBInstanceId

    string

    ID instans.

    rm-uf6wjk5****
    OrderId

    integer

    ID pesanan. Parameter ini hanya didukung oleh instans MySQL.

    21334157599****
    RequestId

    string

    ID permintaan.

    65BDA532-28AF-4122-AA39-B382721EEE64

    Contoh

    Respons sukses

    JSONformat

    {
  "DBInstanceId": "rm-uf6wjk5****",
  "OrderId": 0,
  "RequestId": "65BDA532-28AF-4122-AA39-B382721EEE64"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 RenewChange.Exist The Current InstanceId existed renewChange order in RDS.
    400 InvalidInstanceCommodityCode.NotFound Parse commodityCode from lx and instance fail.
    400 InvalidMigrateModifyClassOrStorage Specified parameter DBInstanceClass or Storage is invalid.
    400 EngineNotSupported Engine specified cannot be supported the operation.
    400 IncorrectDBInstanceLockMode.ValueNotSupported The Current DB instance lock mode does not support this operation.
    400 InvalidZoneId.NotNull The parameter ZoneId must not be null or auto
    400 InvalidZoneId.NotEqual The parameter ZoneId is the same as the previous one
    400 InvalidDispenseMode.Format The specified dispense mode is not valid.
    400 IncorrectDBInstanceType Current DB instance type does not support this operation.
    400 ZoneId.NotMatchWithCategory The Number of ZoneId specified does not match with category
    400 InvalidDefaultVSwitch.NotFound The specified default virtual switch is not found in specified VPC.
    400 InsufficientResourceCapacityCheck There is insufficient capacity available for the requested instance with precheck.
    400 UnsupportedReadOrBakReadState Current DB instance has read or bak read instance running in unsupported states
    400 IncorrectDBInstanceState Current DB instance state does not support this operation.
    400 MirrorInsExists Specified DB instance mirror ins already existed.
    400 SSLInstanceNotSupportThisOperation The instance opened SSL, upgrade is not this operation
    400 BYOLInstanceNotSupportThisOperation The BYOL instance is not supported this operation
    400 BYOKInstanceNotSupportThisOperation The BYOK instance is not supported this operation
    400 ADInstanceNotSupportThisOperation The AD instance is not supported this operation
    400 TDEInstanceNotSupportThisOperation The instance opened TDE, this operation is not supported
    400 InstanceIsSnapshotBackupNotSupportThisOperation The instance backup method is snapshot backup, this operation is not supported
    400 InstanceHasReadOnlyInstanceNotSupportThisOperation The instance has read-only instance or is read-only instance, this operation is not supported
    400 VswitchIpExhausted No available ip in the specified vswitch.
    400 OperationDenied.MasterDBInstanceState The operation is not permitted due to status of master instance.
    400 InvalidShareInstance.NotSupport The share dbInstance is not support.
    400 InvalidZoneIdSlave1.Missing The parameter ZoneIdSlave1 must be specified.
    400 MigrateAlreadyExistsFault The rds instance already has a given vpc migrate task.
    400 InvalidInstanceKind.NotSupport The instance kind does not support this operation.
    400 MissingCategory The instance is missing a category parameter.
    400 InvalidInstanceNodeType.NotFound The specified NodeType is not found.
    400 EngineVersionNotSupported EngineVersion specified cannot be replicate with the source DB Instance.
    400 CommodityCodeNotFound CommodityCodeNotFound
    400 InvalidTunnelId Specified conn tunnel is not valid.
    400 SSLNotSupport The CharacterType of instance does not support SSL.
    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 InvalidConnectionString.Duplicate Specified connection string already exists in the RDS.
    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 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 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.
    400 UnSupportDbTypeReduceDiskSize The current instance does not support scale-in.
    400 UnsupportedReduceDiskSize Current Instance not support reduce disk size less than limit size.
    400 UnsupportExtendDisk.NotSupport Specified DB instance is unsupport extend disk.
    400 ClassicNetDisabled The classic network address is currently disabled, and the instance cannot perform configuration changes.
    400 InvalidParamForXfs Xfs instance must be single tenant standard instance.
    400 InstanceHasLinkedServerInfo The instance has linked server info, please delete linked server info first.
    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 OperationDenied.OutofUsage The resource is out of usage.
    403 IncorrectEffectiveTime The specified EffectiveTime params is not valid.
    403 InvalidTempInstance.NotSupport The temp db Instance is not support.
    403 OperationDenied.LockMode The operation is not permitted due to instance being locked.
    403 ClassicNetworkType.NotSupport The Classic instance network create is not support.
    403 InstanceNetworkTypeNotFoundFault The specified DBInstanceNetworkType is not found.
    403 ProprietaryCloud.NotSupported The proprietary cloud not supported.
    403 MigrateAlreadyReadWriteSplitExistsFault The rds instance already has a given vpc migrate task.
    403 InvalidRegionAvzNotFound Specified user does not find the region and avz.
    403 ZoneIdNotSupported The zone ID is not supported.
    403 InvalidVpcInfo.NotFound Specified VPC info does not exist.
    403 InvalidMultiparamZoneInfoList Zoneinfo list is invaild.
    403 MigrateSlaveNotSupport Current DB instance state does not support migrating slave, please switch the Primary/Secondary Instance first.
    403 CloudDiskEncryptionNotSupport The encryption key is not allowed for general-purpose instance.
    403 IncorrectMinorVersion Current engine minor version does not support operations.
    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 OperationDenied.ZoneResource There is no available zone for inventory.
    403 NotInFlowController Sorry,no permission.
    403 InvalidKmsKey Kms key is disabled.
    403 InvalidInstanceLevel.Malformed Current DB instance level does not support this operation.
    403 InstanceEngineType.NotSupport The instance engine and type does not support operations.
    403 UnsupportedByBlueGreenDeployment Operation prohibited due to blue green deployment.
    403 CurrentRecoveryModelNotSupportThisAction Current recovery model not supported this action.
    403 UnSupportNonXfsDiskSizeTooLarge Non xfs disk types do not support upgrading to 60T or above.
    403 ShrinkCountReachedLimit Current DB shrink count reached the limit.
    403 IncorrectReadDBInstanceDisksize Read instance disk size must be equal or higher than primary instance.
    404 InvalidDBInstanceName.NotFound The database instance does not exist.
    404 IncorrectVswitchId The specified parameter VSwitchId is not valid.
    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.