All Products
Search

This Product

    Elastic Compute Service:ModifyInstanceNetworkSpec

    Document Center

    Elastic Compute Service:ModifyInstanceNetworkSpec

    Last Updated:Jun 24, 2026

    Mengubah konfigurasi bandwidth instans ECS, mengalokasikan alamat IP publik, atau mengonversi metode penagihan jaringan. Peningkatan dan penurunan didukung.

    Deskripsi operasi

    • Ketika Anda mengubah konfigurasi bandwidth instans langganan (PrePaid), alamat IP publik akan secara otomatis dialokasikan jika bandwidth publik keluar (InternetMaxBandwidthOut) ditingkatkan dari 0 Mbit/s ke nilai bukan nol.

    • Ketika Anda mengubah konfigurasi bandwidth instans bayar-sesuai-pemakaian (PostPaid), alamat IP publik tidak secara otomatis dialokasikan jika bandwidth publik keluar (InternetMaxBandwidthOut) ditingkatkan dari 0 Mbit/s ke nilai bukan nol. Atur parameter AllocatePublicIp ke true untuk mengalokasikan alamat IP publik.

    Catatan

    Dalam satu wilayah, total puncak bandwidth publik bayar-per-bandwidth dari satu akun Alibaba Cloud memiliki batas. Untuk informasi lebih lanjut, lihat Batas bandwidth publik.

    • Biaya:

      • Setelah bandwidth ditingkatkan, pembayaran otomatis dipotong secara default. Pastikan metode pembayaran Anda memiliki saldo yang cukup. Jika tidak, pesanan abnormal akan dibuat, dan Anda hanya dapat membatalkan pesanan. Jika saldo akun Anda tidak mencukupi, Anda dapat mengatur parameter AutoPay ke false. Dalam hal ini, pesanan normal yang belum dibayar akan dibuat. Anda dapat masuk ke konsol ECS untuk membayar pesanan.

      • Setelah bandwidth diturunkan, selisih harga dikembalikan ke metode pembayaran asli. Voucher yang telah digunakan tidak dapat dikembalikan.

    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

    ecs:ModifyInstanceNetworkSpec

    update

    *Instance

    acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}
    • ecs:AssociatePublicIpAddress
    		 None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    InstanceId

    string

    Yes

    ID instans yang ingin Anda ubah konfigurasi jaringannya.

    i-bp67acfmxazb4****
    InternetMaxBandwidthOut

    integer

    No

    Bandwidth publik keluar maksimum. Satuan: Mbit/s (Megabit per detik). Nilai yang valid:

    • Bayar-per-lalu-lintas: 0 hingga 100.

    • Bayar-per-bandwidth:

      • Instans langganan: 0 hingga 200.

      • Instans bayar-sesuai-pemakaian: 0 hingga 100.

    Catatan

    Bandwidth keluar maksimum per instans juga dibatasi oleh metrik Baseline/Burstable Bandwidth Jaringan (Gbit/s) dari tipe instans ECS. Untuk informasi lebih lanjut, lihat Keluarga instans.

    10
    InternetMaxBandwidthIn

    integer

    No

    Bandwidth publik masuk maksimum. Satuan: Mbit/s (Megabit per detik). Nilai yang valid:

    • Jika bandwidth publik keluar maksimum yang dibeli kurang dari atau sama dengan 10 Mbit/s: 1 hingga 10. Nilai default: 10.

    • Jika bandwidth publik keluar maksimum yang dibeli lebih besar dari 10 Mbit/s: 1 hingga nilai InternetMaxBandwidthOut. Nilai default: nilai InternetMaxBandwidthOut.

    10
    ISP

    string

    No

    Catatan

    Parameter ini dalam pratinjau undangan dan belum tersedia untuk digunakan.

    null
    NetworkChargeType

    string

    No

    Target konversi untuk metode penagihan jaringan. Nilai yang valid:

    • PayByBandwidth: bayar-per-bandwidth.

    • PayByTraffic: bayar-per-lalu-lintas.

    Catatan

    Dalam mode bayar-per-lalu-lintas, puncak bandwidth masuk dan keluar keduanya merupakan batas atas bandwidth dan tidak dijamin sebagai metrik layanan yang ditetapkan. Ketika terjadi perebutan sumber daya, puncak bandwidth dapat dibatasi. Jika bisnis Anda memerlukan bandwidth yang dijamin, gunakan mode bayar-per-bandwidth.

    PayByTraffic
    AllocatePublicIp

    boolean

    No

    Menentukan apakah akan mengalokasikan alamat IP publik. Nilai yang valid:

    • true: Mengalokasikan alamat IP publik.

    • false: Tidak mengalokasikan alamat IP publik.

    Nilai default: false.

    false
    StartTime

    string

    No

    Waktu mulai peningkatan bandwidth sementara. Tentukan waktu dalam format standar ISO 8601 dalam waktu UTC+0 dengan format yyyy-MM-ddTHH:mmZ. Waktu harus akurat hingga menit (mm).

    2017-12-05T22:40Z
    EndTime

    string

    No

    Waktu berakhir peningkatan bandwidth sementara. Tentukan waktu dalam format standar ISO 8601 dalam waktu UTC+0 dengan format yyyy-MM-ddTHHZ. Waktu harus akurat hingga jam (HH).

    Catatan

    Interval antara waktu berakhir dan waktu mulai peningkatan bandwidth sementara harus lebih besar dari atau sama dengan 3 jam.

    2017-12-06T22Z
    AutoPay

    boolean

    No

    Menentukan apakah akan mengaktifkan pembayaran otomatis. Nilai yang valid:

    • true: Setelah konfigurasi bandwidth diubah, pembayaran otomatis dipotong. Ketika Anda mengatur parameter AutoPay ke true, pastikan akun Anda memiliki saldo yang cukup. Jika saldo akun Anda tidak mencukupi, pesanan abnormal akan dibuat. Anda tidak dapat membayar pesanan di konsol ECS. Anda hanya dapat membatalkan pesanan.

    • false: Setelah konfigurasi bandwidth diubah, hanya pesanan yang dibuat dan tidak ada pembayaran yang dilakukan. Jika metode pembayaran Anda memiliki saldo tidak mencukupi, Anda dapat mengatur parameter AutoPay ke false untuk menonaktifkan pembayaran otomatis. Dalam hal ini, API menghasilkan pesanan normal yang belum dibayar. Anda dapat masuk ke konsol ECS untuk membayar pesanan.

    Nilai default: true.

    true
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Nilai ClientToken hanya dapat berisi karakter ASCII dan tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.

    123e4567-e89b-12d3-a456-426655440000

    Elemen respons

    Element

    Type

    Description

    Example

    object

    OrderId

    string

    ID pesanan. Parameter ini hanya dikembalikan ketika Anda mengubah konfigurasi bandwidth instans langganan (PrePaid).

    123457890
    RequestId

    string

    ID permintaan.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    Contoh

    Respons sukses

    JSONformat

    {
  "OrderId": "123457890",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidInternetMaxBandwidthIn.ValueNotSupported The specified InternetMaxBandwidthIn is beyond the permitted range.
    400 InvalidInternetMaxBandwidthOut.ValueNotSupported The specified InternetMaxBandwidthOut is beyond the permitted range.
    400 OperationDenied Specified instance is in VPC.
    400 InvalidParameter.Conflict %s
    400 InvalidStartTime.ValueNotSupported The specified StartTime is out of the permitted range.
    400 InvalidEndTime.ValueNotSupported The specified EndTime is out of the permitted range.
    400 ChargeTypeViolation The operation is not permitted due to billing method of the instance.
    400 Account.Arrearage Your account has an outstanding payment.
    400 InvalidInternetChargeType.ValueNotSupported The specified InternetChargeType is invalid.
    400 DecreasedBandwidthNotAllowed %s
    400 BandwidthUpgradeDenied.EipBoundInstance The specified VPC instance has bound EIP, temporary bandwidth upgrade is denied.
    400 InvalidClientToken.ValueNotSupported The ClientToken provided is invalid.
    400 Throttling Request was denied due to request throttling, please try again after 5 minutes.
    400 InvalidInstanceStatus.NotStopped The specified Instance status is not Stopped.
    400 InvalidAction Specified action is not valid.
    400 IpAllocationError Allocate public ip failed.
    400 InvalidParam.AllocatePublicIp The specified param AllocatePublicIp is invalid.
    400 InstanceDowngrade.QuotaExceed Quota of instance downgrade is exceed.
    400 InvalidBandwidth.ValueNotSupported Instance upgrade bandwidth of temporary not allow less then existed.
    400 InvalidInstanceStatus The specified instance status does not support this action.
    400 InvalidInstance.UnPaidOrder Unpaid order exists in your account, please complete or cancel the payment in the expense center.
    400 LastOrderProcessing The previous order is still processing, please try again later.
    400 LastRequestProcessing The previous request is still processing, please try again later.
    400 InvalidStartTime.BeyondLifeCycle The specified start time exceeds the expiration time.
    400 InvalidEndTime.BeyondLifeCycle The specified end time exceeds the expiration time.
    400 InvalidPayMethod.SyncPaymentNotSupport Synchronous payment is not supported. Use another payment method.
    400 InvalidBandwidthOut.LessThanZero The bandwidth must be larger than 0 when specifying isp.
    400 InvalidParameter.BandwidthBiggerThanBaseBandwidth %s
    400 InvalidAction.WithActiveElasticUpgrade The instance has active Elastic Upgrade.
    400 InvalidParameter.CloudboxNotSupported %s
    400 InvalidParameter.Bandwidth %s
    400 NoPermission.Price The operation requires price permission. Please either apply for permission from your main account, or set the parameter AutoPay as true.
    400 NoPermission.Refund The operation requires refund permission. Please apply for permission from your main account.
    400 InvalidParameter.DedicatedRegionNotSupported The specified action is rejected because the specified ECS instance in the dedicated region does not support public IP.
    400 InvalidOperation.InstanceStatusUnsupported The specified instance status is not supported for this operation, expect status is Running or Stopped.
    400 QuotaExceeded.InternetBandwidth %s.
    400 UnsupportedIspNetworkChargeType The network charge type is not supported when specifying ISP.
    400 IncorrectInstanceStatus Current instance status does not support this operation.
    400 TaskConflict The operation is too frequent, please wait a moment and try again.
    400 InvalidOperation.InternetMaxBandwidthOutUnsupported The InternetMaxBandwidthOut is not allowed to modify.
    500 InternalError The request processing has failed due to some unknown error.
    500 Image.OrderFailed Create marketplace image order failed.
    403 IncorrectInstanceStatus The current status of the instance does not support this operation.
    403 InstanceLockedForSecurity The specified operation is denied as your instance is locked for security reasons.
    403 InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
    403 ChargeTypeViolation The operation is not permitted due to billing method of the instance.
    403 OperationDenied The operation is denied due to the instance is PrePaid.
    403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance.
    403 InvalidInstance.UnPaidOrder The specified Instance has unpaid order.
    403 Throttling Request was denied due to request throttling, please try again after 5 minutes.
    403 InvalidInstance.InstanceNotSupported The special vpc instance with eip not need bandwidth.
    403 InstanceDowngrade.QuotaExceed Quota of instance downgrade is exceed.
    403 InvalidInstanceStatus The current status of the instance does not support this operation.
    403 InvalidOperation.StarterPackage StarterPackage not support modification.
    403 NAT_PUBLIC_IP_BINDING_FAILED Binding nat public ip failed.
    403 InvalidInstance.EipNotSupport The specified instance with eip is not supported, please unassociate eip first.
    403 InvalidInstance.NatPortMapNotSupport The special instance with nat port map not support operate, please remove nat port map first.
    403 OperationDenied.UnpaidOrder The specified instance has unpaid order.
    403 Mayi.InternalError The request processing has failed due to some unknown error.
    403 InvalidNetworkType.ValueNotSupported The specified parameter NetworkType is not valid.
    403 OperationDenied.ImageNotValid The specified image is not authorized.
    403 InvalidInstanceChargeType.ValueNotSupported The specified parameter ChargeType is not valid.
    403 InvalidIspType.ValueNotSupported %s
    403 UnsupportedIspChargeType %s
    403 UnsupportedIspClassicNetwork %s
    403 InvalidIspBandwidthOut %s
    403 UnsupportedChangeIsp %s
    403 InvalidIspUID %s
    403 UnsupportedIspRegion %s
    403 BandIncreaseNotSupportIsp %s
    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.
    403 InvalidOperation.PublicIpAddressNoStock The public IP address for the specified Region or ChargeType of the instance is out of stock. Please try another Region or ChargeType.
    403 InvalidOperation.NetworkTypeUnsupported The specified network type is not supported in this region.
    404 InvalidInstanceId.NotFound The specified InstanceId does not exist.
    409 OperationConflict Request was denied due to conflict with a previous request,please try again later.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.