ModifyInstanceNetworkSpec - - Alibaba Cloud Documentation Center

Memodifikasi konfigurasi bandwidth instance Elastic Compute Service (ECS) untuk meningkatkan kinerja jaringan.

Catatan penggunaan

Sebelum memanggil operasi ini, perhatikan hal-hal berikut:

Mulai 27 November 2020, nilai bandwidth maksimum yang tersedia untuk membuat atau mengubah konfigurasi instance ECS tunduk pada Kebijakan throttling akun Anda. Untuk menaikkan batas bandwidth, ajukan tiket. Kebijakan throttling berikut berlaku:
- Di satu wilayah, jumlah bandwidth puncak aktual semua instance ECS yang menggunakan metode penagihan bayar-per-lalu-lintas untuk penggunaan jaringan tidak boleh melebihi 5 Gbit/s.
- Di satu wilayah, jumlah bandwidth puncak aktual semua instance ECS yang menggunakan metode penagihan bayar-per-bandwidth untuk penggunaan jaringan tidak boleh melebihi 50 Gbit/s.
Jika Anda meningkatkan bandwidth publik keluar (InternetMaxBandwidthOut) instance langganan (PrePaid) dari 0 Mbit/s saat memodifikasi konfigurasi bandwidth, alamat IP publik akan secara otomatis ditetapkan ke instance tersebut.
Jika Anda meningkatkan bandwidth publik keluar (InternetMaxBandwidthOut) instance bayar sesuai penggunaan (PostPaid) dari 0 Mbit/s saat memodifikasi konfigurasi bandwidth, alamat IP publik tidak akan secara otomatis ditetapkan. Anda harus mengatur AllocatePublicIp ke true atau memanggil operasi AllocatePublicIpAddress untuk menetapkan alamat IP publik ke instance tersebut.
Instance dalam jaringan klasik harus berada dalam status Stopped sebelum Anda dapat meningkatkan bandwidth publik keluar (InternetMaxBandwidthOut) dari 0 Mbit/s.
Setelah bandwidth ditingkatkan, AutoPay diatur ke true secara default dan pembayaran dilakukan secara otomatis. Pastikan saldo akun Anda mencukupi. Jika tidak, pesanan Anda menjadi tidak valid dan dibatalkan. Jika saldo akun tidak mencukupi, Anda dapat mengatur AutoPay ke false. Dalam hal ini, saat Anda memanggil operasi ModifyInstanceNetworkSpec, pesanan yang belum dibayar akan dibuat. Anda kemudian dapat masuk ke Konsol ECS untuk membayar pesanan tersebut.
Selisih harga dikembalikan ke akun pembayaran yang Anda gunakan. Voucher atau kupon yang telah ditukarkan tidak dapat dikembalikan.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan 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	Type	Required	Example	Description
Action	String	Yes	ModifyInstanceNetworkSpec	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyInstanceNetworkSpec.
InstanceId	String	Yes	i-bp67acfmxazb4****	ID instance yang konfigurasi bandwidth-nya ingin Anda modifikasi.
InternetMaxBandwidthOut	Integer	No	10	Bandwidth publik keluar maksimum. Satuan: Mbit/s. Nilai valid: 0 hingga 100.
InternetMaxBandwidthIn	Integer	No	10	Bandwidth masuk publik 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`.
ISP	String	No	null	Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.
NetworkChargeType	String	No	PayByTraffic	Metode penagihan untuk penggunaan jaringan. Nilai valid: PayByBandwidth PayByTraffic Catatan Jika metode penagihan bayar-per-lalu-lintas digunakan untuk penggunaan jaringan, bandwidth masuk dan keluar maksimum hanya berfungsi sebagai batas atas bandwidth, bukan sebagai jaminan kinerja. Dalam skenario di mana permintaan melebihi pasokan sumber daya, nilai bandwidth maksimum mungkin tidak tercapai. Jika Anda memerlukan bandwidth terjamin untuk instance Anda, gunakan metode penagihan bayar-per-bandwidth untuk penggunaan jaringan.
AllocatePublicIp	Boolean	No	false	Menentukan apakah akan menetapkan alamat IP publik ke instance. Nilai valid: true false Nilai default: false.
StartTime	String	No	2017-12-05T22:40Z	Waktu mulai peningkatan bandwidth sementara. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddThh:mmZ. Waktu harus dalam UTC dan akurat hingga menit (mm).
EndTime	String	No	2017-12-06T22Z	Waktu berakhir peningkatan bandwidth sementara. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddThhZ. Waktu harus dalam UTC dan akurat hingga jam (hh). Catatan Selang waktu antara waktu berakhir dan waktu mulai peningkatan bandwidth sementara harus lebih besar dari atau sama dengan 3 jam.
AutoPay	Boolean	No	true	Menentukan apakah pembayaran akan diselesaikan secara otomatis. Nilai valid: true: Setelah Anda memodifikasi konfigurasi bandwidth, pembayaran akan diselesaikan secara otomatis. Pastikan saldo akun Anda mencukupi sebelum mengatur AutoPay ke true. Jika saldo akun Anda tidak mencukupi, pesanan Anda tidak dapat dibayar di Konsol ECS dan menjadi tidak valid. Anda harus membatalkan pesanan tersebut. false: Setelah Anda memodifikasi konfigurasi bandwidth, pesanan akan dibuat tetapi pembayaran tidak diselesaikan. Jika saldo akun Anda tidak mencukupi, Anda dapat mengatur AutoPay ke false untuk membuat pesanan yang belum dibayar. Kemudian, Anda dapat login ke Konsol ECS untuk membayar pesanan tersebut. Nilai default: true.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	Token klien yang ingin Anda gunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token. Pastikan token klien unik digunakan untuk setiap permintaan. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.

Parameter respons

Parameter	Type	Example	Description
OrderId	String	123457890	ID pesanan.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.

Contoh

Contoh permintaan

https://ecs.aliyuncs.com/?Action=ModifyInstanceNetworkSpec
&InstanceId=i-bp67acfmxazb4p****
&InternetMaxBandwidthOut=10
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<Common request parameters>

Contoh respons sukses

XML format

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

<ModifyInstanceNetworkSpecResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
    <OrderId>123457890</OrderId>
</ModifyInstanceNetworkSpecResponse>

JSON format

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

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

Kode kesalahan

HttpCode	Error code	Error message	Description
400	InvalidInternetMaxBandwidthIn.ValueNotSupported	The specified InternetMaxBandwidthIn is beyond the permitted range.	Bandwidth masuk publik maksimum yang ditentukan melebihi nilai maksimum yang diizinkan.
400	InvalidInternetMaxBandwidthOut.ValueNotSupported	The specified InternetMaxBandwidthOut is beyond the permitted range.	Bandwidth keluar publik maksimum yang ditentukan melebihi nilai maksimum yang diizinkan.
400	OperationDenied	Specified instance is in VPC.	Instance berada dalam virtual private cloud (VPC).
400	InvalidParameter.Conflict	%s	Parameter yang ditentukan tidak valid. Periksa apakah terdapat konflik parameter. %s adalah variabel. Pesan kesalahan dikembalikan secara dinamis berdasarkan kondisi pemanggilan.
400	ChargeTypeViolation	The operation is not permitted due to billing method of the instance.	Metode penagihan instance tidak mendukung operasi ini.
400	InvalidStartTime.ValueNotSupported	%s	Waktu berakhir tidak boleh lebih awal daripada waktu mulai.
400	Account.Arrearage	Your account has an outstanding payment.	Akun Anda memiliki pesanan yang belum dibayar.
400	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is invalid.	Parameter InternetChargeType yang ditentukan tidak valid.
400	DecreasedBandwidthNotAllowed	%s	Operasi downgrade bandwidth tidak valid.
400	BandwidthUpgradeDenied.EipBoundInstance	The specified VPC instance has bound EIP, temporary bandwidth upgrade is denied.	Instance dikaitkan dengan elastic IP address (EIP), sehingga bandwidth jaringan instance tidak dapat ditingkatkan secara sementara.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	Nilai ClientToken tidak valid.
400	Throttling	Request was denied due to request throttling, please try again after 5 minutes.	Permintaan Anda dibatasi. Coba lagi dalam 5 menit.
400	InvalidAction	Specified action is not valid.	Operasi tidak valid.
400	IpAllocationError	Allocate public ip failed.	Alamat IP publik tidak dapat ditetapkan.
400	InvalidParam.AllocatePublicIp	The specified param AllocatePublicIp is invalid.	Nilai AllocatePublicIp yang ditentukan tidak valid.
400	InstanceDowngrade.QuotaExceed	Quota of instance downgrade is exceed.	Jumlah maksimum downgrade konfigurasi yang diizinkan untuk instance telah terlampaui.
400	InvalidBandwidth.ValueNotSupported	Instance upgrade bandwidth of temporary not allow less then existed.	Bandwidth baru yang ditentukan untuk peningkatan bandwidth sementara lebih rendah daripada bandwidth saat ini.
400	InvalidInstanceStatus	The specified instance status does not support this action.	Instance berada dalam status yang tidak mendukung operasi ini.
400	InvalidInstance.UnPaidOrder	Unpaid order exists in your account, please complete or cancel the payment in the expense center.	Akun Anda memiliki pesanan yang belum dibayar. Bayar pesanan tersebut dan coba lagi.
400	OperationDenied	After downgrade, you cannot upgrade or downgrade your instances again in the remaining time of the current billing cycle.	Setelah Anda menurunkan spesifikasi instance, Anda tidak dapat melakukan peningkatan atau penurunan spesifikasi lagi hingga siklus penagihan baru dimulai.
400	InvalidInternetChargeType.ValueNotSupported	%s	Nilai InternetChargeType tidak valid.
400	LastOrderProcessing	The previous order is still processing, please try again later.	Pesanan sedang diproses. Coba lagi nanti.
400	OperationDenied	The current user does not support this operation.	Akun Anda tidak mendukung operasi ini.
400	InvalidAction.WithActiveElasticUpgrade	The instance has active Elastic Upgrade.	Operasi tidak dapat dilakukan pada instance saat konfigurasi instance sedang mengalami peningkatan sementara. Konfigurasi instance mengalami peningkatan sementara jika operasi ModifyPrepayInstanceSpec dipanggil dengan EndTime yang ditetapkan.
400	InvalidParameter.Bandwidth	%s	Bandwidth yang ditentukan tidak valid. Periksa nilai parameter.
400	InvalidParameter.DedicatedRegionNotSupported	The specified action is rejected because the specified ECS instance in the dedicated region does not support public IP.	Instance ECS di wilayah khusus tidak mendukung parameter ini.
403	IncorrectInstanceStatus	The current status of the instance does not support this operation.	Operasi ini tidak dapat dilakukan pada instance dalam status saat ini.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	Instance dikunci karena alasan keamanan.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).	Instance telah kedaluwarsa atau memiliki pembayaran tertunda. Perpanjang atau selesaikan pembayaran untuk instance tersebut dan coba lagi.
403	OperationDenied	The operation is denied due to the instance is PrePaid.	Instance merupakan instansi langganan dan tidak mendukung operasi ini.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	Saldo akun Anda tidak mencukupi. Tambahkan dana ke akun Anda dan coba lagi.
403	InvalidInstance.UnPaidOrder	The specified Instance has unpaid order.	Anda memiliki pesanan yang belum dibayar untuk instance yang ditentukan. Bayar pesanan tersebut dan coba lagi.
403	InvalidInstance.InstanceNotSupported	The special vpc instance with eip not need bandwidth.	Instance berada dalam VPC dan dikaitkan dengan EIP. Anda tidak dapat menentukan bandwidth publik untuk instance tersebut.
403	InvalidInstanceStatus	The current status of the instance does not support this operation.	Operasi ini tidak dapat dilakukan pada instance dalam status saat ini.
403	InvalidInstance.EipNotSupport	The specified instance with eip is not supported, please unassociate eip first.	Operasi ini tidak dapat dilakukan pada instance yang dikaitkan dengan EIP. Putuskan kaitan EIP terlebih dahulu.
403	OperationDenied.UnpaidOrder	The specified instance has unpaid order.	Anda memiliki pesanan yang belum dibayar untuk instance tersebut. Anda dapat login ke Konsol ECS untuk membayar pesanan tersebut.
403	InvalidNetworkType.ValueNotSupported	The specified parameter NetworkType is not valid.	Jenis jaringan yang ditentukan tidak valid.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Operasi ini tidak dapat dilakukan pada resource dalam status saat ini.
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 kartu debit default Anda. Klik URL dalam email untuk verifikasi.
500	InternalError	The request processing has failed due to some unknown error.	Terjadi kesalahan internal. Coba lagi nanti.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Terjadi kesalahan internal. Coba lagi nanti.

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.