All Products
Search

This Product

    ApsaraDB RDS:MigrateToOtherZone

    Document Center

    ApsaraDB RDS:MigrateToOtherZone

    Last Updated:Jun 12, 2026

    Memigrasikan instans ApsaraDB RDS ke zona yang berbeda.

    Deskripsi operasi

    Mesin yang didukung

    • ApsaraDB RDS for MySQL

    • ApsaraDB RDS for PostgreSQL

    • ApsaraDB RDS for SQL Server.

    Dokumentasi terkait

    Penting Sebelum memanggil operasi ini, baca dokumentasi berikut dan pastikan Anda sepenuhnya memahami prasyarat serta dampak dari 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 DescribeDBInstances untuk mendapatkan ID instans.

    rm-uf6wjk5****
    VPCId

    string

    No

    ID virtual private cloud (VPC). VPC tidak dapat diubah selama migrasi instans.

    • Parameter ini wajib diisi saat Anda memigrasikan instans yang terhubung ke VPC ke zona yang berbeda.

    • Jika mesin instans adalah SQL Server, VPC dapat diubah selama migrasi instans.

    vpc-****
    ZoneId

    string

    Yes

    ID zona tujuan. Anda dapat memanggil DescribeRegions untuk mendapatkan ID zona.

    cn-hangzhou-b
    EffectiveTime

    string

    No

    Periode efektif. Nilai valid:

    • Immediate: Migrasi berlaku segera. Ini adalah nilai default.

    • MaintainTime: Migrasi berlaku selama jendela pemeliharaan. Untuk informasi selengkapnya, lihat ModifyDBInstanceMaintainTime.

    • ScheduleTime: Migrasi berlaku pada waktu kustom.

    Catatan

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

    Immediate
    VSwitchId

    string

    No

    ID vSwitch.

    • Parameter ini wajib diisi saat Anda memigrasikan instans yang terhubung ke VPC ke zona yang berbeda. Anda dapat memanggil DescribeVSwitches untuk mengkueri vSwitch aktif.

    • Saat Anda melakukan migrasi instans untuk instans ApsaraDB RDS for PostgreSQL atau SQL Server ke zona yang berbeda dengan zona sekunder yang dikonfigurasi, Anda dapat menentukan beberapa ID vSwitch yang dipisahkan oleh koma (,), sesuai dengan zona.

    vsw-uf6adz52c2p****
    Category

    string

    No

    Edisi instans. Nilai valid:

    • Basic: Edisi Dasar

    • HighAvailability: seri ketersediaan tinggi

    • AlwaysOn: Edisi Kluster SQL Server

    • cluster: Edisi Kluster MySQL

    • Finance: Edisi Perusahaan RDS.

    HighAvailability
    ZoneIdSlave1

    string

    No

    Zona sekunder 1.

    Catatan

    Parameter ini wajib untuk instans yang bukan Edisi Dasar.

    cn-hangzhou-c
    ZoneIdSlave2

    string

    No

    Zona sekunder 2.

    Catatan

    Parameter ini hanya berlaku untuk instans Edisi Perusahaan RDS.

    cn-hangzhou-d
    SwitchTime

    string

    No

    Waktu pengalihan kustom saat migrasi zona berlaku. Tentukan waktu dalam format yyyy-MM-ddTHH:mm:ssZ (UTC).

    Catatan

    Parameter ini digunakan bersama dengan parameter EffectiveTime dan hanya wajib diisi ketika periode efektif yang ditentukan oleh EffectiveTime ditetapkan ke ScheduleTime. Parameter ini hanya aktif ketika EffectiveTime ditetapkan ke ScheduleTime.

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

    string

    No

    Apakah akan mengubah spesifikasi instans selama migrasi zona.

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

    • false: Tidak mengubah spesifikasi. Ini adalah nilai default.

    Catatan

    Parameter ini hanya berlaku untuk instans ApsaraDB RDS for MySQL.

    true
    DBInstanceClass

    string

    No

    Kode tipe instans target. Hanya tipe instans yang dapat diubah. Tipe penyimpanan tidak dapat diubah. Saat pengaturan parameter IsModifySpec mencakup true, Anda harus menentukan setidaknya satu dari parameter ini dan DBInstanceStorage.

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

    mysql.x4.xlarge.2
    DBInstanceStorage

    integer

    No

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

    Unit: GB. Nilai valid: Kapasitas penyimpanan bervariasi berdasarkan tipe instans. Untuk informasi selengkapnya, lihat Tipe instans utama ApsaraDB RDS for MySQL.

    500
    IoAccelerationEnabled

    string

    No

    Apakah akan mengaktifkan fitur Buffer Pool Extension (BPE) untuk disk performa premium. Nilai valid:

    • 1: diaktifkan

    • 0: dinonaktifkan

    Catatan

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

    0
    DBInstanceStorageType

    string

    No

    Tipe penyimpanan instans. Nilai valid:

    • cloud_essd: cloud disk ESSD PL1.

    • cloud_essd2: cloud disk ESSD PL2.

    • cloud_essd3: cloud disk ESSD PL3.

    • cloud_ssd: SSD standar (tidak direkomendasikan karena SSD standar tidak lagi tersedia untuk dibeli di beberapa wilayah).

    cloud_essd
    CustomExtraInfo

    string

    No

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter tanggapan.

    DBInstanceId

    string

    ID instans.

    rm-uf6wjk5****
    OrderId

    integer

    ID pesanan. Parameter ini hanya berlaku untuk instans ApsaraDB RDS for 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.