All Products
Search

This Product

    ApsaraDB RDS:UpgradeDBInstanceMajorVersion

    Document Center

    ApsaraDB RDS:UpgradeDBInstanceMajorVersion

    Last Updated:Jun 12, 2026

    Memulai tugas peningkatan versi utama untuk instans RDS PostgreSQL.

    Deskripsi operasi

    Mesin yang didukung

    RDS PostgreSQL

    Dokumentasi fitur terkait

    Operasi API ini melibatkan biaya. Baca dokumentasi fitur terkait dengan saksama untuk memastikan Anda sepenuhnya memahami biaya yang timbul akibat penggunaan API, prasyarat, dan dampak setelah penggunaan sebelum melakukan operasi.

    Meningkatkan versi mesin utama instans ApsaraDB RDS for PostgreSQL.

    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

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    rds:UpgradeDBInstanceMajorVersion

    update

    *DBInstance

    acs:rds:*:{#accountId}:dbinstance/{#DBInstanceId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    DBInstanceClass

    string

    No

    Tipe instans setelah peningkatan. Konfigurasi CPU dan memori harus lebih besar atau sama dengan tipe instans asli. Ketika UpgradeMode (mode peningkatan) diatur ke inPlaceUpgrade atau zeroDownTimeUpgrade, parameter ini tidak perlu dikonfigurasi.

    Sebagai contoh, tipe instans asli pg.n2.small.2c memiliki 1 inti CPU dan memori 2 GB, dan dapat ditingkatkan ke pg.n2.medium.2c yang memiliki 2 inti CPU dan memori 4 GB.

    Catatan

    Untuk kode tipe instans RDS PG, lihat Tipe instans utama RDS PostgreSQL.

    pg.n2.medium.2c
    DBInstanceStorage

    integer

    No

    Kapasitas penyimpanan instans setelah peningkatan. Unit: GB. Ketika UpgradeMode (mode peningkatan) diatur ke inPlaceUpgrade atau zeroDownTimeUpgrade, parameter ini tidak perlu dikonfigurasi.

    Nilai valid:

    • ESSD PL1 disk: 20 GB hingga 3200 GB

    • ESSD PL2 disk: 500 GB hingga 3200 GB

    • ESSD PL3 disk: 1500 GB hingga 3200 GB

    • SSD standar: 40 GB hingga 2000 GB

    Catatan

    Instans dengan disk lokal berkinerja tinggi mendukung pengurangan kapasitas penyimpanan saat meningkatkan versi utama. Untuk kapasitas penyimpanan minimum yang dapat dipilih, lihat Meningkatkan versi mesin utama instans ApsaraDB RDS for PostgreSQL.

    20
    PayType

    string

    Yes

    Metode penagihan. Parameter ini tetap menggunakan pay-as-you-go, dengan nilai Postpaid.

    Catatan

    Jika Anda ingin mengubah metode penagihan instans setelah peningkatan, lihat Mengubah metode penagihan dari pay-as-you-go ke langganan.

    Postpaid
    InstanceNetworkType

    string

    No

    Jenis jaringan instans setelah peningkatan. Parameter ini tetap ke VPC. Saat ini, hanya instans VPC yang mendukung peningkatan versi utama.

    Jika jenis jaringan adalah jaringan klasik, beralih ke VPC terlebih dahulu. Untuk informasi tentang cara melihat atau beralih jenis jaringan, lihat Beralih jenis jaringan.

    VPC
    SwitchTimeMode

    string

    No

    Parameter ini digunakan bersama dengan SwitchOver dan hanya berlaku ketika parameter SwitchOver diatur ke true. Parameter ini menunjukkan waktu alih bencana.

    Nilai valid:

    • Immediate: Berlaku segera.

    • MaintainTime: Berlaku selama jendela pemeliharaan. Anda dapat memanggil API ModifyDBInstanceMaintainTime untuk memodifikasi jendela pemeliharaan.

    Immediate
    SwitchTime

    string

    No

    Parameter cadangan. Anda tidak perlu mengonfigurasi parameter ini.

    2021-07-10T13:15:12Z
    SwitchOver

    string

    No

    Konfigurasi alih bencana. Pilih apakah akan mengalihkan Trafik ke instans versi baru berdasarkan kebutuhan aktual.

    Nilai valid:

    • true: Alih bencana dengan pengalihan otomatis. Opsi ini biasanya digunakan untuk melakukan peningkatan formal setelah mengonfirmasi bahwa bisnis berjalan stabil pada versi baru.

    • false: Tidak melakukan alih bencana dan tidak melakukan pengalihan otomatis. Opsi ini biasanya digunakan untuk menguji kompatibilitas bisnis saat ini dengan versi baru sebelum peningkatan formal.

    Catatan
    • Jika Anda memilih untuk melakukan alih bencana:

      • Rollback tidak didukung setelah alih bencana. Pilih dengan hati-hati.

      • Selama pengalihan, instans asli menjadi read-only dan tidak dapat menerima penulisan. Pastikan untuk melakukan operasi ini di luar jam sibuk.

      • Jika instans read-only telah dibuat untuk instans asli, Anda tidak dapat memilih untuk melakukan alih bencana. Anda hanya dapat meningkatkan instans tanpa alih bencana, dan instans read-only asli tidak akan dikloning. Setelah peningkatan selesai, Anda perlu membuat instans read-only PostgreSQL baru secara terpisah untuk instans versi baru.

    • Jika Anda memilih untuk tidak melakukan alih bencana:

      • Selama migrasi, bisnis pada instans asli tidak akan terpengaruh.

      • Jika Anda perlu meningkatkan instans tanpa alih bencana, setelah migrasi selesai, Anda harus mengubah alamat koneksi database di aplikasi ke alamat koneksi instans baru. Untuk informasi tentang cara melihat alamat koneksi, lihat Melihat atau mengubah endpoint internal dan publik serta nomor Port.

    false
    CollectStatMode

    string

    No

    Menentukan kapan akan mengumpulkan statistik pada database.

    • Before: Mengumpulkan sebelum alih bencana. Hal ini memastikan stabilitas bisnis. Jika instans berisi data dalam jumlah besar, peningkatan mungkin memakan waktu lama.

    • After: Mengumpulkan setelah alih bencana. Peningkatan instans lebih cepat. Setelah peningkatan, mengakses tabel yang statistiknya belum dihasilkan dapat menghasilkan rencana eksekusi yang tidak akurat dan bahkan dapat menyebabkan database crash selama jam sibuk bisnis.

    Catatan

    Untuk skenario tanpa alih bencana, mengumpulkan statistik sebelum alih bencana berarti mengumpulkan sebelum instans baru dibuka untuk read/write, dan mengumpulkan setelah alih bencana berarti mengumpulkan setelah instans baru dibuka untuk read/write.

    After
    TargetMajorVersion

    string

    No

    Versi utama target instans setelah peningkatan. Hal ini harus konsisten dengan versi target yang ditetapkan selama pemeriksaan pra-peningkatan.

    Catatan

    Anda dapat memanggil API UpgradeDBInstanceMajorVersionPrecheck untuk melakukan pemeriksaan awal sebelum peningkatan versi utama.

    13.0
    DBInstanceId

    string

    No

    ID instans asli.

    pgm-bp1gm3yh0ht1****
    VPCId

    string

    No

    ID VPC. Ketika UpgradeMode (mode peningkatan) diatur ke inPlaceUpgrade atau zeroDownTimeUpgrade, parameter ini tidak perlu dikonfigurasi.

    Anda dapat memanggil API DescribeDBInstanceAttribute untuk melihat ID VPC instans asli.

    vpc-bp1opxu1zkhn00gzv****
    VSwitchId

    string

    No

    ID vSwitch instans target. Ketika UpgradeMode (mode peningkatan) diatur ke inPlaceUpgrade atau zeroDownTimeUpgrade, parameter ini tidak perlu dikonfigurasi.

    • Jika instans asli adalah instans Edisi Dasar, konfigurasikan ID vSwitch instans target.

    • Jika instans asli adalah instans edisi ketersediaan tinggi, Anda dapat mengonfigurasi ID vSwitch instans utama dan sekunder target, dipisahkan dengan koma (,).

    Catatan

    vSwitch instans target yang dikonfigurasi harus berada di zona yang sama dengan instans asli. Anda dapat memanggil API DescribeVSwitches untuk mengkueri.

    vsw-bp10aqj6o4lclxdrm****,vsw-bp10aqj6o4lclxdrm****
    PrivateIpAddress

    string

    No

    Anda tidak perlu mengonfigurasi parameter ini. Parameter ini menunjukkan alamat IP internal instans target. Sistem secara otomatis mengalokasikan alamat IP berdasarkan VPCId dan vSwitchId secara default.

    172.16.XX.XX
    UsedTime

    string

    No

    Parameter cadangan. Anda tidak perlu mengonfigurasi parameter ini.

    1
    Period

    string

    No

    Parameter cadangan. Anda tidak perlu mengonfigurasi parameter ini.

    Month
    DBInstanceStorageType

    string

    No

    Tipe penyimpanan instans setelah peningkatan.

    Nilai valid:

    • cloud_ssd: SSD

    • cloud_essd: ESSD PL1

    • cloud_essd2: ESSD PL2

    • cloud_essd3: ESSD PL3

    • general_essd: SSD standar

    Fitur peningkatan versi didasarkan pada snapshot disk. Tipe penyimpanan yang dapat dipilih setelah peningkatan saat ini adalah sebagai berikut.

    • Jika instans asli menggunakan SSD, Anda dapat memilih SSD.

    • Jika instans asli menggunakan ESSD, Anda dapat memilih ESSD PL1, ESSD PL2, ESSD PL3, atau SSD standar.

    • Jika instans asli menggunakan disk lokal berkinerja tinggi, Anda dapat memilih ESSD PL1, ESSD PL2, ESSD PL3, atau SSD standar.

    cloud_essd
    ZoneId

    string

    No

    ID zona utama target. Ketika UpgradeMode (mode peningkatan) diatur ke inPlaceUpgrade atau zeroDownTimeUpgrade, parameter ini tidak perlu dikonfigurasi.

    Anda dapat memanggil API DescribeRegions untuk melihat ID zona.

    RDS PostgreSQL mendukung konfigurasi instans baru ke zona lain di wilayah yang sama dengan instans asli setelah peningkatan.

    cn-hangzhou-j
    ZoneIdSlave1

    string

    No

    Parameter ini hanya dapat dikonfigurasi ketika instans asli adalah instans edisi ketersediaan tinggi. Parameter ini menunjukkan ID zona sekunder instans target. Ketika UpgradeMode (mode peningkatan) diatur ke inPlaceUpgrade atau zeroDownTimeUpgrade, parameter ini tidak perlu dikonfigurasi.

    RDS PostgreSQL mendukung konfigurasi instans sekunder baru ke zona lain di wilayah yang sama dengan instans asli setelah peningkatan.

    Anda dapat memanggil API DescribeRegions untuk melihat ID zona.

    cn-hangzhou-j
    ZoneIdSlave2

    string

    No

    Parameter cadangan. Anda tidak perlu mengonfigurasi parameter ini.

    cn-hangzhou-j
    UpgradeMode

    string

    No

    Mode peningkatan. Ketika SwitchOver (konfigurasi alih bencana) diatur ke true, parameter ini harus dikonfigurasi. Nilai valid:

    • inPlaceUpgrade: Peningkatan di tempat. Tugas peningkatan versi utama dilakukan pada instans asli, dan tidak ada instans versi baru yang dibuat. Setelah peningkatan, versi utama instans asli ditingkatkan, dan pesanan asli, nama instans, tag, aturan peringatan CloudMonitor, serta aturan cadangan diwariskan.

    • blueGreenDeployment: Penerapan biru-hijau. Peningkatan versi utama mempertahankan instans asli dan membuat instans versi baru. Instans baru tidak dikenakan biaya selama pembuatan tetapi akan dikenakan biaya setelah berhasil dibuat, dan metode penagihan dapat berubah. Setelah peningkatan selesai, instans asli dan instans baru akan dikenakan biaya, dan instans baru tidak memenuhi syarat untuk diskon yang berlaku pada instans asli.

    • zeroDownTimeUpgrade: Waktu henti nol. Sistem menggunakan pg_upgrade untuk meningkatkan instans asli ke versi target dan menggunakan replikasi logis native untuk melakukan pembaruan inkremental. Proses peningkatan mendukung alih bencana aktif dan memungkinkan verifikasi instans versi tinggi sebelum alih bencana. Dari awal peningkatan hingga alih bencana aktif, instans dapat mempertahankan operasi read/write normal. Selama alih bencana, waktu read-only instans berada pada level detik.

    inPlaceUpgrade
    CustomExtraInfo

    string

    No

    AllowDDL

    boolean

    No

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Detail parameter tanggapan.

    DBInstanceId

    string

    ID instans.

    pgm-bp1gm3yh0ht1****
    OrderId

    string

    ID pesanan.

    21128667463****
    RequestId

    string

    ID permintaan.

    006729E5-2A33-5955-89E3-651D3F44EBE6
    TaskId

    integer

    Parameter cadangan.

    416980000

    Contoh

    Respons sukses

    JSONformat

    {
  "DBInstanceId": "pgm-bp1gm3yh0ht1****",
  "OrderId": "21128667463****",
  "RequestId": "006729E5-2A33-5955-89E3-651D3F44EBE6",
  "TaskId": 416980000
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidUpgradePrecheckResult The upgrade precheck failed. No successful precheck task found in the past 7 days
    400 TargetEngineVersion.Parameters.NotFound targetEngineVersion is missing in the request.
    400 InvalidDBInstanceStorageType The specified DBInstanceStorageType is invalid.
    400 InvalidInstanceNetworkType The specified InstanceNetworkType is invalid.
    400 InvalidVPCId The specified VPCId is invalid.
    400 InvalidDedicatedHostGroupId The specified DedicatedHostGroupId is invalid.
    400 InvalidPayType The specified PayType is invalid.
    400 InvalidEngineVersion The specified EngineVersion is invalid.
    400 InvalidDBInstanceStorage The specified DBInstanceStorage is invalid.
    400 InvalidSwitchOver The specified SwitchOver is invalid.
    400 PrimaryInstanceWithReadonlyNotSupport The specified primary instance with the read-only instance does not support the operation.
    400 InvalidSwitchTimeMode The specified SwitchTimeMode is invalid.
    400 InvalidSwitchTime The specified SwitchTime is invalid.
    400 InvalidCollectStats The specified CollectStats is invalid.
    400 IncorrectDBInstanceState The current instance state does not support this operation.
    400 InvalidDBinstanceClass.ValueNotSupported The specified parameter DBinstanceClass is invalid.
    400 InvalidUpgradeMode The Specified UpgradeMode is not valid.
    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 InvalideStatus.Format The instance status does not support this operation.
    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 MirrorInsExists Specified DB instance mirror ins already existed.
    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 InvalidVSwitchId.Format The specified vswitch Id format is incorrect.
    400 UpgradeModeNotSupport For instances with local SSD, this upgrade Mode is not allowed. For instances with cloud SSD, it is recommended to upgrade minor version at first.
    500 InvalidUpgradeMode The Specified Parameter UpgradeMode is not valid.
    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 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 IncorrectMinorVersion Current engine minor version does not support operations.
    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.
    404 InvalidDBInstanceName.NotFound The database instance does not exist.
    404 IncorrectDBInstanceLockMode Current DB instance lock mode does not support this operation.
    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.