All Products
Search
Document Center

:ModifyPrepayInstanceSpec

Last Updated:May 22, 2026

Menambah atau menurunkan spesifikasi tipe instans dari instance Elastic Compute Service (ECS) berlangganan. Tipe instans baru berlaku selama sisa siklus hidup instance tersebut.

Catatan penggunaan

Sebelum memanggil operasi ini, pastikan Anda memahami metode penagihan, daftar harga, dan aturan pengembalian dana ECS. Untuk informasi lebih lanjut, lihat Aturan pengembalian dana untuk penurunan konfigurasi secara real-time.

Sebelum mengubah tipe instans instance berlangganan, Anda dapat memanggil operasi DescribeResourcesModification untuk mengetahui tipe instans yang tersedia untuk perubahan. Anda juga dapat menggunakan ECS SDK untuk Python guna menanyakan tipe instans yang tersedia. Untuk informasi lebih lanjut, lihat Menanyakan resource yang tersedia untuk perubahan konfigurasi.

Perhatikan hal-hal berikut:

  • Anda tidak dapat mengubah tipe instans instance yang telah kedaluwarsa. Perpanjang masa berlaku instance tersebut, lalu coba lagi.

  • Saat menurunkan spesifikasi tipe instans suatu instance, perhatikan hal-hal berikut:

    • Instance harus berada dalam status Stopped (Stopped).

    • Selisih harga akan dikembalikan ke akun pembayaran yang Anda gunakan. Voucher yang telah ditukarkan tidak dapat dikembalikan.

  • Operasi ini bersifat asinkron. Perubahan tipe instans memerlukan waktu 5 hingga 10 detik. Setelah itu, restart instance dengan memanggil operasi RebootInstance atau melalui Konsol ECS agar perubahan tipe instans berlaku. Jika Anda hanya me-restart sistem operasi instance, perubahan tipe instans tidak akan berlaku.

    • Jika instance berada dalam status Stopped, cukup jalankan instance tersebut. Tidak perlu melakukan restart setelah instance masuk ke status Running.

    • Jika parameter RebootWhenFinished diatur ke true, Anda tidak perlu me-restart instance secara manual.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan memanggil operasi ini di OpenAPI Explorer, yang secara dinamis menghasilkan contoh kode untuk berbagai SDK.

Parameter permintaan

Parameter

Type

Required

Example

Description

Action

String

Yes

ModifyPrepayInstanceSpec

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyPrepayInstanceSpec.

InstanceId

String

Yes

i-bp67acfmxazb4ph****

ID instance.

RegionId

String

Yes

cn-hangzhou

ID wilayah instance. Anda dapat memanggil operasi DescribeRegions untuk menanyakan daftar wilayah terbaru.

InstanceType

String

Yes

ecs.g5.xlarge

Tipe instans baru. Untuk informasi tentang tipe instans yang tersedia, lihat Keluarga instans atau panggil operasi DescribeInstanceTypes.

OperatorType

String

No

upgrade

Jenis operasi. Nilai yang valid:

Catatan

Parameter ini opsional. Sistem dapat menentukan jenis operasi secara otomatis. Jika Anda ingin menentukan parameter ini, perhatikan aturan berikut:

  • upgrade: menaikkan spesifikasi tipe instans. Pastikan saldo akun Anda mencukupi.

  • downgrade: menurunkan spesifikasi tipe instans. Saat tipe instans baru yang ditentukan oleh InstanceType memiliki spesifikasi lebih rendah daripada tipe instans saat ini, tetapkan OperatorType ke downgrade.

Catatan

Untuk informasi lebih lanjut tentang hal-hal yang perlu diperhatikan saat menaikkan atau menurunkan spesifikasi tipe instans, lihat bagian "Catatan penggunaan" di atas.

ClientToken

String

No

123e4567-e89b-12d3-a456-426655440000

Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menghasilkan nilainya dari sisi klien, tetapi pastikan nilainya unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.

AutoPay

Boolean

No

true

Menentukan apakah pembayaran otomatis diaktifkan saat Anda menaikkan spesifikasi tipe instans. Nilai yang valid:

  • true: Pembayaran dilakukan secara otomatis.

    Catatan

    Pastikan saldo akun Anda mencukupi. Jika tidak, pesanan Anda menjadi tidak valid. Jika saldo akun Anda tidak mencukupi, Anda dapat mengatur AutoPay ke false untuk menghasilkan pesanan yang belum dibayar. Setelah itu, Anda dapat login ke Konsol ECS untuk membayar pesanan tersebut.

  • false: Pesanan dihasilkan tetapi tidak dilakukan pembayaran.

Nilai default: true.

Saat OperatorType diatur ke downgrade, AutoPay diabaikan.

MigrateAcrossZone

Boolean

No

false

Menentukan apakah peningkatan tipe instans lintas kluster didukung.

Nilai default: false.

Saat Anda mengatur MigrateAcrossZone ke true dan menaikkan spesifikasi instans berdasarkan informasi yang dikembalikan, perhatikan hal-hal berikut:

Instance tipe jaringan klasik:

  • Untuk tipe instans yang telah ditarik, alamat IP pribadi, nama perangkat disk, dan kode lisensi perangkat lunak dari instance non-I/O teroptimasi akan berubah saat Anda menaikkan spesifikasinya menjadi instance I/O teroptimasi. Pada instance Linux, disk dasar (cloud) diidentifikasi sebagai xvd* seperti xvda dan xvdb. Disk ultra (cloud_efficiency) dan SSD standar (cloud_ssd) diidentifikasi sebagai vd* seperti vda dan vdb.

  • Untuk keluarga instans yang dapat dibeli, alamat IP pribadi instance akan berubah saat Anda mengubah tipe instansnya.

Instance tipe Virtual Private Cloud (VPC): Untuk tipe instans yang telah ditarik, saat instance non-I/O teroptimasi dinaikkan menjadi instance I/O teroptimasi, nama perangkat disk dan kode lisensi perangkat lunak instance akan berubah. Pada instance Linux, disk dasar (cloud) diidentifikasi sebagai xvd* seperti xvda dan xvdb. Disk ultra (cloud_efficiency) dan SSD standar (cloud_ssd) diidentifikasi sebagai vd* seperti vda dan vdb.

SystemDisk.Category

String

No

cloud_efficiency

Kategori baru untuk disk sistem. Parameter ini hanya berlaku saat Anda menaikkan spesifikasi instance dari tipe instans yang telah ditarik ke tipe instans yang tersedia, atau saat Anda menaikkan spesifikasi instance non-I/O teroptimasi menjadi instance I/O teroptimasi. Untuk informasi lebih lanjut, lihat Tipe instans yang telah ditarik dan Keluarga instans. Nilai yang valid:

  • cloud_efficiency: disk ultra.

  • cloud_ssd: SSD standar.

RebootTime

String

No

2018-01-01T12:05Z

Waktu restart instance. Tentukan waktu dalam format standar ISO 8601 yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

EndTime

String

No

2018-01-01T12:05Z

Waktu berakhirnya perubahan sementara. Tentukan waktu dalam format standar ISO 8601 yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

RebootWhenFinished

Boolean

No

false

Menentukan apakah instance akan segera direstart setelah perubahan tipe instans selesai. Nilai yang valid:

  • true: me-restart instance segera setelah perubahan tipe instans selesai.

  • false: tidak me-restart instance segera setelah perubahan tipe instans selesai.

Nilai default: false.

Catatan

Jika instance berada dalam status Stopping, status instance tetap tidak berubah dan tidak ada operasi yang dilakukan, terlepas dari apakah RebootWhenFinished diatur ke true atau tidak.

ModifyMode

String

No

null

Catatan

Parameter ini tidak tersedia untuk umum.

Disk.N.DiskId

String

No

null

Catatan

Parameter ini tidak tersedia untuk umum.

Disk.N.Category

String

No

null

Catatan

Parameter ini tidak tersedia untuk umum.

Disk.N.PerformanceLevel

String

No

null

Catatan

Parameter ini tidak tersedia untuk umum.

Parameter respons

Parameter

Type

Example

Description

OrderId

String

1234567890

ID pesanan.

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID permintaan.

Contoh

Contoh permintaan

https://ecs.aliyuncs.com/?Action=ModifyPrepayInstanceSpec
&RegionId=cn-hangzhou
&InstanceId=i-bp67acfmxazb4ph****
&InstanceType=ecs.g5.xlarge
&AutoPay=true
&OperatorType=upgrade
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<Common request parameters>

Contoh respons sukses

XML format

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

<ModifyPrepayInstanceSpecResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
    <OrderId>1234567890</OrderId>
</ModifyPrepayInstanceSpecResponse>

JSON format

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

{
  "RequestId" : "04F0F334-1335-436C-A1D7-6C044FE73368",
  "OrderId" : "1234567890"
}

Kode kesalahan

Kode status HTTP

Kode kesalahan

Pesan kesalahan

Deskripsi

400

InvalidInstanceType.ValueUnauthorized

The specified InstanceType is not authorized.

Anda tidak memiliki otorisasi untuk menggunakan tipe instans tersebut.

400

InvalidInstanceType.ValueNotSupported

The specified InstanceType does not exist or beyond the permitted range.

Tipe instans tidak ditemukan, atau Anda tidak memiliki otorisasi untuk mengelola instance dengan tipe instans tersebut.

400

InvalidBillingMethod.ValueNotSupported

The operation is not permitted due to an invalid billing method of the instance.

Operasi tidak didukung karena metode penagihan instance tidak valid.

400

InvalidInstance.PurchaseNotFound

The specified instance has no purchase history.

Catatan pesanan untuk instance tidak ditemukan.

400

InvalidInstanceType.NotSupported

The specified InstanceType is not Supported.

Nilai InstanceType tidak valid.

400

OrderCreationFailed

Order creation failed, please check your params and try it again later.

Pesanan tidak dapat dibuat. Ubah pengaturan parameter Anda dan coba lagi.

400

Throttling

You have made too many requests within a short time; your request is denied due to request throttling.

Permintaan Anda ditolak karena pembatasan kecepatan. Coba lagi nanti.

400

Account.Arrearage

Your account has an outstanding payment.

Akun Anda memiliki pesanan yang belum dibayar.

400

InvalidInstanceId.NotFound

The specified InstanceId does not exist.

Instance ini tidak ditemukan. Periksa apakah ID instance yang ditentukan valid.

400

InvalidRebootTime.MalFormed

The specified rebootTime is not valid.

Nilai RebootTime tidak valid.

400

InvalidRebootTime.ValueNotSupported

The specified RebootTime is not valid.

Waktu restart yang ditentukan tidak valid.

400

IdempotenceParamNotMatch

Request uses a client token in a previous request but is not identical to that request.

Permintaan ini dan permintaan sebelumnya menggunakan token klien yang sama tetapi parameter lainnya berbeda.

400

IdempotenceParamNotMatch

%s

Parameter idempoten tidak cocok.

400

InvalidInstanceChargeType.ValueNotSupported

%s

Metode penagihan yang ditentukan tidak didukung.

400

InvalidStatus.NotStopped

Instance status must be stopped.

Operasi hanya dapat dilakukan saat instance berada dalam status Stopped.

400

InvalidAction

%s

Operasi tidak valid.

400

InstanceDowngrade.QuotaExceed

Quota of instance downgrade is exceed.

Jumlah maksimum penurunan konfigurasi yang diizinkan untuk instance telah terlampaui.

400

InvalidInstanceType.ValueNotSupported

%s

Tipe instans tidak mendukung operasi ini.

400

InvalidParameter

%s

Nilai parameter tidak valid.

400

OperationDenied

The current user does not support this operation.

Akun Anda tidak mendukung operasi ini.

400

LastOrderProcessing

The previous order is still processing, please try again later.

Pesanan sedang diproses. Coba lagi nanti.

400

InvalidOperation.VpcHasEnabledAdvancedNetworkFeature

The specified vpc has enabled advanced network feature.

Fitur lanjutan diaktifkan untuk VPC. Anda tidak dapat membuat instance ECS dengan spesifikasi rendah di VPC tersebut.

400

InvalidAction.WithActiveElasticUpgrade

The instance has active Elastic Upgrade.

Operasi tidak dapat dilakukan pada instance saat konfigurasinya sedang mengalami peningkatan sementara. Konfigurasi instance mengalami peningkatan sementara jika operasi ModifyPrepayInstanceSpec dipanggil dengan EndTime diatur.

400

QuotaExceed.DiskCapacity

The used capacity of disk type has exceeded the quota in the zone, %s.

Kapasitas maksimum disk yang termasuk dalam kategori disk tertentu telah terlampaui di zona tersebut. Anda dapat membuka Pusat Kuota untuk melihat dan menambah kuota kapasitas disk.

400

QuotaExceed.RufundVcpu

The maximum number of refunded vcpu is exceeded: %s .

Jumlah maksimum vCPU yang dikembalikan telah terlampaui. Untuk informasi lebih lanjut tentang jumlah tersebut, lihat nilai kembali dari placeholder %s dalam pesan kesalahan.

403

OperationDenied.NoStock

The specified instance is out of usage.

Resource dari tipe instans yang ditentukan tidak mencukupi.

403

InvalidUser.PassRoleForbidden

The RAM user does not have privilege to pass a role.

Pengguna Manajemen Akses Sumber Daya (RAM) tidak memiliki otorisasi untuk menetapkan peran RAM.

403

ImageNotSupportInstanceType

The specified image does not support the specified InstanceType.

Gambar yang ditentukan tidak mendukung tipe instans yang ditentukan.

403

InstanceType.Offline

%s

Operasi tidak dapat dilakukan pada instance saat tipe instans telah ditarik atau saat resource dari tipe instans tersebut tidak mencukupi.

403

IncorrectInstanceStatus

The current status of the resource does not support this operation.

Operasi tidak dapat dilakukan pada resource dalam status saat ini.

403

InvalidParameter.InstanceId

%s

Nilai InstanceId tidak valid.

403

OperationDenied

%s

Operasi ditolak.

403

ImageNotSupportInstanceType

The specified instanceType is not supported by instance with marketplace image.

Gambar Marketplace Alibaba Cloud yang ditentukan tidak mendukung tipe instans tersebut.

403

InvalidInstanceStatus

The current status of the instance does not support this operation.

Operasi tidak dapat dilakukan pada instance dalam status saat ini.

403

InvalidInstance.EipNotSupport

The special instance with eip not support operate, please unassociate eip first.

Operasi tidak dapat dilakukan pada instance saat alamat IP elastis (EIP) terasosiasi dengan instance tersebut. Putuskan asosiasi EIP terlebih dahulu.

403

OperationDenied.LocalDiskUnsupported

The configuration change is not allowed when the specified instance has local disks mounted.

Tipe instans dari instance yang menggunakan disk lokal tidak dapat diubah.

403

OperationDenied.NoStock

The resource is out of stock in the specified zone. Please try other types, or choose other regions and zones.

Resource yang ditentukan tidak tersedia di zona yang ditentukan. Coba tipe resource lain atau pilih wilayah atau zona lain.

403

InvalidOperation.Ipv4CountExceeded

%s

Jumlah maksimum alamat IPv4 telah terlampaui.

403

InvalidOperation.Ipv6CountExceeded

%s

Jumlah maksimum alamat IPv6 telah terlampaui.

403

InvalidOperation.Ipv6NotSupport

%s

Alamat IPv6 tidak mendukung operasi ini.

403

InvalidInstance.NotFoundSystemDisk

The specified instance has no system disk.

Instance yang ditentukan tidak memiliki disk sistem yang terpasang. Pastikan instance yang ditentukan memiliki disk sistem yang terpasang. Anda dapat memanggil operasi DescribeInstances untuk menanyakan detail instance tersebut.

403

InvalidInstanceType.NotSupportDiskCategory

The instanceType of the specified instance does not support this disk category.

Tipe instans yang ditentukan oleh InstanceType tidak mendukung kategori disk dari instance tersebut. Coba tipe instans lain. Untuk informasi tentang kategori disk yang didukung oleh tipe instans, lihat dokumentasi keluarga instans.

403

QuotaExceed.ElasticQuota

No additional quota is available for the specified ECS instance type.

Jumlah maksimum instance dari tipe instans yang ditentukan di wilayah tersebut telah terlampaui. Coba wilayah atau tipe instans lain, atau kurangi jumlah pembelian. Anda dapat membuka Konsol ECS atau Pusat Kuota untuk meminta peningkatan kuota.

403

QuotaExceed.ElasticQuota

The number of the specified ECS instances has exceeded the quota of the specified instance type.

Jumlah maksimum instance dari tipe instans yang ditentukan di wilayah tersebut telah terlampaui. Coba wilayah atau tipe instans lain, atau kurangi jumlah pembelian. Anda dapat membuka Konsol ECS atau Pusat Kuota untuk meminta peningkatan kuota.

403

QuotaExceed.ElasticQuota

The number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.

Jumlah maksimum vCPU untuk semua tipe instans di zona tersebut telah terlampaui. Anda dapat membuka Konsol ECS atau Pusat Kuota untuk meminta peningkatan kuota.

403

QuotaExceed.ElasticQuota

The number of the specified ECS instances has exceeded the quota of the specified instance type, or the number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.

Jumlah maksimum instance dari tipe instans yang ditentukan di wilayah tersebut, atau jumlah maksimum vCPU untuk semua tipe instans di zona tersebut telah terlampaui. Anda dapat membuka Konsol ECS atau Pusat Kuota untuk meminta peningkatan kuota.

403

InvalidOperation.MaxEniQueueNumberExceeded

%s

Jumlah maksimum antrian per antarmuka jaringan elastis (ENI) telah terlampaui. Untuk informasi lebih lanjut, lihat nilai kembali dari placeholder %s dalam pesan kesalahan.

403

InvalidOperation.ExceedInstanceTypeQueueNumber

%s

Jumlah maksimum antrian untuk semua ENI telah terlampaui. Untuk informasi lebih lanjut, lihat nilai kembali dari placeholder %s dalam pesan kesalahan.

403

InvalidParameter.InvalidEniQueueNumber

%s

Jumlah antrian per ENI tidak valid. Untuk informasi lebih lanjut, lihat nilai kembali dari placeholder %s dalam pesan kesalahan.

403

HibernationConfigured.InstanceOperationForbidden

The operation is not permitted due to limit of the hibernation configured instance.

Operasi tidak dapat dilakukan karena batasan pada instance yang telah diaktifkan fitur hibernasi.

403

OperationDenied.UnpaidOrder

The specified instance has unpaid order.

Akun Anda memiliki pesanan yang belum dibayar untuk instance yang ditentukan. Anda dapat login ke Konsol ECS untuk membayar pesanan tersebut.

404

InvalidRegionId.NotFound

The specified RegionId does not exist.

Nilai RegionId tidak valid.

404

BillingMethodNotFound

The account has not chosen any billing method.

Tidak ada metode penagihan yang dipilih untuk akun Alibaba Cloud.

500

InternalError

The request processing has failed due to some unknown error, exception or failure.

Terjadi kesalahan internal. Coba lagi nanti.

500

InternalError

The request processing has failed due to some unknown error.

Terjadi kesalahan internal. Coba lagi nanti.

Untuk daftar lengkap kode kesalahan, lihat Kode Kesalahan Layanan.