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:
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:
Nilai default: true. Saat |
MigrateAcrossZone | Boolean | No | false | Menentukan apakah peningkatan tipe instans lintas kluster didukung. Nilai default: false. Saat Anda mengatur Instance tipe jaringan klasik:
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:
|
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:
Nilai default: false. Catatan Jika instance berada dalam status Stopping, status instance tetap tidak berubah dan tidak ada operasi yang dilakukan, terlepas dari apakah |
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.