All Products
Search

This Product

    :ModifyInstanceSpec

    Document Center

    :ModifyInstanceSpec

    Last Updated:May 22, 2026

    Mengubah tipe instans dan bandwidth publik instance Elastic Compute Service (ECS) berbayar sesuai penggunaan (pay-as-you-go).

    Catatan Penggunaan

    Untuk informasi tentang cara menggunakan ECS SDK untuk Python guna mengubah konfigurasi resource, lihat Kueri resource yang tersedia untuk perubahan konfigurasi.

    Perhatikan hal-hal berikut:

    • Pastikan akun Anda tidak memiliki pembayaran tertunda.
    • Anda hanya dapat menyesuaikan bandwidth publik suatu instans ketika instans berada dalam status Running (Running) atau Stopped (Stopped).
    • Sebelum mengubah tipe instans dari instans pay-as-you-go, panggil operasi DescribeResourcesModification untuk mengkueri tipe instans yang kompatibel.
    • Anda hanya dapat mengubah tipe instans ketika instans berada dalam status Stopped (Stopped).
    • Tipe instans dan bandwidth publik suatu instans tidak dapat diubah secara bersamaan.
    • Sejak 27 November 2020, total bandwidth yang tersedia untuk semua instans (baru maupun yang dimodifikasi) tunduk pada kebijakan pembatasan kecepatan (throttling) akun Anda. Untuk meningkatkan batas bandwidth, kirimkan tiket. Kebijakan pembatasan kecepatan berikut berlaku:
      • Dalam satu wilayah, jumlah bandwidth puncak aktual semua instance ECS yang menggunakan metode penagihan jaringan bayar-per-lalu-lintas (pay-by-traffic) tidak boleh melebihi 5 Gbit/s.
      • Dalam satu wilayah, jumlah bandwidth puncak aktual semua instance ECS yang menggunakan metode penagihan jaringan bayar-per-bandwidth (pay-by-bandwidth) tidak boleh melebihi 50 Gbit/s.

    Debugging

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

    Parameter Permintaan

    Parameter

    Tipe

    Wajib

    Contoh

    Deskripsi
    Action String Ya ModifyInstanceSpec

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyInstanceSpec.

    InstanceId String Ya i-bp67acfmxazb4p****

    ID instans.

    InstanceType String Tidak ecs.g6.large

    Tipe instans baru. Untuk informasi selengkapnya, lihat Ikhtisar keluarga instans. Atau, Anda juga dapat memanggil operasi DescribeInstanceTypes untuk mengkueri daftar tipe instans terbaru.

    InternetMaxBandwidthOut Integer Tidak 10

    Bandwidth publik keluar maksimum. Satuan: Mbit/s. Nilai valid: 0 hingga 100.

    Catatan Ketika metode penagihan jaringan pay-by-traffic digunakan, nilai bandwidth masuk dan keluar maksimum berfungsi sebagai batas atas bandwidth, bukan jaminan performa. Dalam skenario di mana permintaan melebihi pasokan resource, nilai bandwidth maksimum tersebut mungkin tidak tercapai. Jika Anda menginginkan bandwidth yang dijamin untuk instans Anda, kami menyarankan agar Anda menggunakan metode penagihan pay-by-bandwidth.
    InternetMaxBandwidthIn Integer Tidak 10

    Bandwidth publik masuk maksimum. Satuan: Mbit/s. Nilai valid:

    • Jika bandwidth publik keluar yang dibeli kurang dari atau sama dengan 10 Mbit/s, nilai valid parameter ini adalah 1 hingga 10 dan nilai default-nya adalah 10.
    • Jika bandwidth publik keluar yang dibeli lebih dari 10 Mbit/s, nilai valid parameter ini adalah 1 hingga nilai InternetMaxBandwidthOut dan nilai default-nya adalah nilai InternetMaxBandwidthOut.
    Catatan Ketika metode penagihan jaringan pay-by-traffic digunakan, bandwidth masuk dan keluar maksimum berfungsi sebagai batas atas bandwidth, bukan jaminan performa. Dalam skenario di mana permintaan melebihi pasokan resource, nilai bandwidth maksimum tersebut mungkin tidak tercapai. Jika Anda menginginkan bandwidth yang dijamin untuk instans Anda, kami menyarankan agar Anda menggunakan metode penagihan pay-by-bandwidth.
    Temporary.StartTime String Tidak null
    Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.
    Temporary.EndTime String Tidak null
    Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.
    Temporary.InternetMaxBandwidthOut Integer Tidak null
    Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.
    Async Boolean Tidak false

    Menentukan apakah permintaan asinkron akan dikirimkan. Nilai valid:

    • true
    • false

    Nilai default: false.

    AllowMigrateAcrossZone Boolean Tidak false

    Menentukan apakah upgrade tipe instans lintas kluster didukung.

    • true
    • false

    Nilai default: false.

    Ketika AllowMigrateAcrossZone diatur ke true dan Anda melakukan upgrade instans berdasarkan informasi yang dikembalikan, perhatikan hal-hal berikut:

    Instans yang berada di jaringan klasik:

    • Untuk tipe instans yang telah ditarik, alamat IP pribadi, nama perangkat disk, dan kode otorisasi perangkat lunak dari instans non-I/O teroptimasi akan berubah saat Anda meng-upgrade instans tersebut menjadi instans I/O teroptimasi. Untuk instans Linux, disk dasar (cloud) diidentifikasi sebagai xvd* seperti xvda dan xvdb, sedangkan disk ultra (cloud_efficiency) dan SSD standar (cloud_ssd) diidentifikasi sebagai vd* seperti vda dan vdb.
    • Untuk keluarga instans yang tersedia untuk pembelian, ketika tipe instans diubah, alamat IP pribadi instans tersebut juga berubah. Untuk informasi selengkapnya, lihat Ikhtisar keluarga instans.

    Instans yang berada di virtual private cloud (VPC): Untuk tipe instans yang telah ditarik, ketika instans non-I/O teroptimasi di-upgrade menjadi instans I/O teroptimasi, nama perangkat disk dan kode otorisasi perangkat lunak instans tersebut berubah. Untuk informasi selengkapnya, lihat Tipe instans yang telah ditarik. Untuk instans Linux, disk dasar (cloud) diidentifikasi sebagai xvd* seperti xvda dan xvdb, sedangkan disk ultra (cloud_efficiency) dan SSD standar (cloud_ssd) diidentifikasi sebagai vd* seperti vda dan vdb.

    SystemDisk.Category String Tidak cloud_ssd

    Kategori baru untuk disk sistem. Nilai valid:

    • cloud_efficiency: disk ultra.
    • cloud_ssd: SSD standar.
    Catatan Parameter ini hanya berlaku ketika Anda meng-upgrade instans dari tipe instans yang telah ditarik ke tipe instans yang tersedia, atau ketika Anda meng-upgrade instans non-I/O teroptimasi menjadi instans I/O teroptimasi. Untuk informasi selengkapnya, lihat Tipe instans yang telah ditarik dan Ikhtisar keluarga instans.
    ClientToken String Tidak 0c593ea1-3bea-11e9-b96b-88e9fe637760

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menghasilkan token ini di sisi klien, tetapi harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.

    ModifyMode String Tidak null
    Catatan Parameter ini tidak tersedia untuk umum.
    Disk.N.DiskId String Tidak null
    Catatan Parameter ini tidak tersedia untuk umum.
    Disk.N.Category String Tidak null
    Catatan Parameter ini tidak tersedia untuk umum.
    Disk.N.PerformanceLevel String Tidak null
    Catatan Parameter ini tidak tersedia untuk umum.

    Parameter Respons

    Parameter

    Tipe

    Contoh

    Deskripsi
    RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    ID permintaan.

    Contoh

    Contoh permintaan

    https://ecs.aliyuncs.com/?Action=ModifyInstanceSpec
&InstanceId=i-bp67acfmxazb4p****
&InstanceType=ecs.g6.large
&InternetMaxBandwidthOut=10
&ClientToken=0c593ea1-3bea-11e9-b96b-88e9fe637760
&<Common request parameters>

    Contoh respons sukses

    XML format

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

<ModifyInstanceSpecResponse>
   <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
</ModifyInstanceSpecResponse>

    JSON format

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

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

    Kode Kesalahan

    Kode status HTTP

    Kode kesalahan

    Pesan kesalahan

    Deskripsi
    400 InvalidInternetChargeType.ValueNotSupported The specified InternetChargeType is not valid. Metode penagihan jaringan tidak valid.
    400 InvalidInstanceType.ValueUnauthorized The specified InstanceType does not exist or beyond the permitted range. Tipe instans tidak ditemukan, atau Anda tidak memiliki otorisasi untuk mengelola instans dengan tipe tersebut.
    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 instans dengan tipe tersebut.
    400 InvalidParameter.Mismatch Too many parameters in one request. Jumlah maksimum parameter dalam permintaan telah terlampaui.
    400 BandwidthUpgradeDenied.EipBoundInstance The specified VPC instance has bound EIP, temporary bandwidth upgrade is denied. Instans terkait dengan alamat IP elastis (EIP), sehingga bandwidth jaringannya tidak dapat ditingkatkan secara temporary.
    400 InvalidTemporary.StartTime The specifed Temporary.StartTime is not valid. Waktu mulai periode peningkatan sementara yang ditentukan tidak valid.
    400 InvalidTemporary.EndTime The specifed Temporary.EndTime is not valid. Nilai Temporary.EndTime tidak valid.
    400 Downgrade.NotSupported Downgrade operation is not supported. Penurunan spesifikasi tidak didukung.
    400 DependencyViolation.InstanceType The current InstanceType cannot be changed to the specified InstanceType. Anda tidak dapat mengubah instans ke tipe instans yang ditentukan.
    400 Account.Arrearage Your account has an outstanding payment. Akun Anda memiliki pesanan yang belum dibayar.
    400 InvalidParameter.Bandwidth The specified parameter Bandwidth is not valid. Bandwidth tidak valid.
    400 InvalidParameter.Conflict The specified image does not support the specified instance type. Gambar yang ditentukan tidak dapat digunakan untuk tipe instans yang ditentukan.
    400 InvalidParameter.AllowMigrateAcrossZone The specified parameter CanMigrateAcrossZone is not valid. Nilai AllowMigrateAcrossZone tidak valid.
    400 InvalidParam.SystemDiskCategory The specified param SystemDisk.Category is not valid. Nilai SystemDisk.Category tidak valid.
    400 Throttling Request was denied due to request throttling, please try again after 5 minutes. Permintaan Anda sedang dibatasi. Coba lagi dalam 5 menit.
    400 InvalidInstanceStatus.NotStopped The specified Instance status is not stopped. Instans yang ditentukan tidak berada dalam status Stopped.
    400 InvalidAction Specified action is not valid. Operasi tidak valid.
    400 IdempotenceParamNotMatch There is a idempotence signature mismatch between this and last request. Permintaan ini dan permintaan sebelumnya memiliki token klien yang sama tetapi parameter lainnya berbeda.
    400 InvalidClientToken.ValueNotSupported The ClientToken provided is invalid. Nilai ClientToken tidak valid.
    400 Price.PricePlanResultNotFound The internetMaxBandwidthIn or internetMaxBandwidthOut provided is invalid. Nilai InternetMaxBandwidthIn atau InternetMaxBandwidthOut tidak valid.
    400 InvalidAction.NotSupport The ecs on dedicatedHost not support modify instanceType. Anda tidak dapat mengubah tipe instans dari instans yang di-host pada host khusus.
    400 InvalidMarketImageStatus.NotSupported The status of specified market image does not support this operation. Operasi ini tidak dapat dilakukan pada gambar Marketplace Alibaba Cloud dalam status saat ini.
    400 InvalidOperation.VpcHasEnabledAdvancedNetworkFeature The specified vpc has enabled advanced network feature. Fitur lanjutan diaktifkan untuk VPC. Anda tidak dapat membuat instans ECS dengan spesifikasi rendah di VPC tersebut.
    400 Invalid.PrivatePoolOptions.MatchCriteria Target mode does not support this operation. Operasi ini tidak dapat dilakukan ketika PrivatePoolOptions.MatchCriteria diatur ke Target.
    400 InvalidDiskCategory.NotSupported The upgrade operation of instance does not support this category of disk. Operasi peningkatan konfigurasi instans tidak mendukung kategori disk tersebut.
    400 QuotaExceed.DiskCapacity The used capacity of disk type has exceeded the quota in the zone, %s. Kapasitas disk yang termasuk dalam kategori disk yang ditentukan melebihi batas kuota untuk zona tersebut. Anda dapat membuka Pusat Kuota untuk melihat dan meningkatkan kuota.
    400 InvalidParam.Async The specified parameter async is not valid. Nilai Async tidak valid.
    403 CategoryViolation The specified instance does not support this operation because of its disk category. Konfigurasi instans yang memiliki disk lokal yang terpasang tidak dapat diubah.
    403 InvalidStatus.ValueNotSupported The current status of the resource does not support this operation. Operasi ini tidak dapat dilakukan pada resource dalam status saat ini.
    403 InstanceLockedForSecurity The specified operation is denied as your instance is locked for security reasons. Instans dikunci karena alasan keamanan.
    403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance. Saldo akun tidak mencukupi. Tambahkan dana ke akun Anda dan coba lagi.
    403 ChargeTypeViolation The operation is not permitted due to charge type of the instance. Operasi ini tidak dapat dilakukan pada instans yang menggunakan metode penagihan saat ini.
    403 OperationDenied The specified instance is out of usage. Stok tipe instans yang ditentukan tidak mencukupi.
    403 LastTokenProcessing The last token request is processing. Permintaan token sedang diproses. Coba lagi nanti.
    403 InstanceSpecModification.NotEffective The specified instance has been reserved for making a spec modification and not taken effective in the current contract period. Instans telah dicadangkan untuk perubahan tipe instans. Perubahan yang dilakukan pada instans tersebut tidak dapat berlaku selama periode kontrak saat ini.
    403 InvalidInstanceType.ValueNotSupported The specified zone does not offer the specified instancetype. Tipe instans tidak tersedia di wilayah yang ditentukan.
    403 ImageNotSupportInstanceType The specified image do not support the InstanceType instance. Gambar yang ditentukan tidak mendukung tipe instans tersebut.
    403 InvalidParameter.NotMatch %s Parameter tidak valid. Periksa apakah terdapat konflik parameter.
    403 InvalidInstance.EipNotSupport The specified instance with eip is not supported, please unassociate eip first. Operasi ini tidak dapat dilakukan pada instans yang terkait dengan EIP. Putuskan asosiasi EIP terlebih dahulu.
    403 OperationDenied.NoStock The resource is out of usage. Instans tidak berada dalam status Running. Jalankan instans atau periksa apakah operasi tersebut valid.
    403 OperationDenied.UnpaidOrder The specified instance has unpaid order. Anda memiliki pesanan yang belum dibayar untuk instans tersebut. Anda dapat login ke Konsol ECS untuk membayar pesanan tersebut.
    403 OperationDenied %s Operasi ditolak.
    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 InvalidOperation.InstanceWithEipNotSupport The special instance with eip not support operate, please unassociate eip first. Operasi ini tidak dapat dilakukan pada instans yang terkait dengan EIP. Putuskan asosiasi EIP terlebih dahulu.
    403 SecurityRisk.3DVerification We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email. Risiko terdeteksi pada kartu kredit atau debit default Anda. Klik URL dalam email untuk verifikasi.
    403 InvalidInstance.NotFoundSystemDisk The specified instance has no system disk. Instans tidak memiliki disk sistem yang terpasang. Pastikan instans memiliki disk sistem yang terpasang. Anda dapat memanggil operasi DescribeInstances untuk mengkueri detail instans tersebut.
    403 InvalidInstanceType.NotSupportDiskCategory The instanceType of the specified instance does not support this disk category. Tipe instans yang ditentukan tidak mendukung kategori disk dari instans 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 instans dengan tipe instans yang ditentukan di wilayah tersebut telah terlampaui. Coba wilayah atau tipe instans lain, atau kurangi jumlah instans yang ingin Anda buat. Anda juga 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 instans dengan tipe instans yang ditentukan di wilayah tersebut telah terlampaui. Coba wilayah atau tipe instans lain, atau kurangi jumlah instans yang ingin Anda buat. Anda juga 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 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 instans dengan tipe instans yang ditentukan di wilayah tersebut, atau jumlah maksimum vCPU untuk semua tipe instans telah terlampaui. Anda dapat membuka Konsol ECS atau Pusat Kuota untuk meminta peningkatan kuota.
    403 InvalidOperation.InstanceTypeNotSupportEniTrunking %s Operasi tidak didukung. Untuk informasi selengkapnya, lihat nilai kembali placeholder %s dalam pesan kesalahan.
    403 InvalidOperation.MaxEniQueueNumberExceeded %s Jumlah maksimum antrian pada ENI telah terlampaui. Untuk informasi selengkapnya, lihat nilai kembali placeholder %s dalam pesan kesalahan.
    403 InvalidOperation.ExceedInstanceTypeQueueNumber %s Jumlah maksimum antrian untuk semua ENI pada suatu instans telah terlampaui. Untuk informasi selengkapnya, lihat nilai kembali placeholder %s dalam pesan kesalahan.
    403 InvalidParameter.InvalidEniQueueNumber %s Jumlah antrian untuk ENI tidak valid. Untuk informasi selengkapnya, lihat nilai kembali 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 keterbatasan instans yang telah mengaktifkan fitur hibernasi instans.
    404 InvalidInstanceId.NotFound The specified InstanceId does not exist. ID instans tidak ditemukan.
    404 MissingTemporary.StartTime Temporary.StartTime is not specified. Waktu mulai periode peningkatan sementara tidak ditentukan.
    404 MissingTemporary.EndTime Temporary.EndTime is not specified. Waktu akhir periode peningkatan sementara tidak ditentukan.
    404 InvalidInstanceChargeType.NotFound The InstanceChargeType does not exist in our records. Metode penagihan instans tidak ditemukan.
    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 kode kesalahan, lihat Kode kesalahan layanan.