All Products
Search

This Product

    ENS:ModifyInstanceChargeType

    Document Center

    ENS:ModifyInstanceChargeType

    Last Updated:Jun 11, 2026

    Panggil ModifyInstanceChargeType untuk mengubah metode penagihan satu atau beberapa instans ENS. Konversi didukung antara instans pay-as-you-go tingkat instans dan instans berlangganan (PrePaid). Untuk instans pay-as-you-go tingkat instans, cloud disk pay-as-you-go yang dibuat bersama instans tersebut juga dapat dikonversi menjadi cloud disk berlangganan.

    Deskripsi operasi

    Sebelum menggunakan API ini, pastikan Anda telah sepenuhnya memahami metode penagihan dan harga produk ENS.

    Metode penagihan hanya dapat diubah ketika instans target berada dalam status Running atau Stopped dan tidak memiliki saldo tertunggak.

    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

    ens:ModifyInstanceChargeType

    update

    *Instance

    acs:ens:*:{#accountId}:instance/{#InstanceId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    InstanceIds

    array

    Yes

    Daftar ID instans.

    string

    No

    ID instans.

    i-5xlrc9wdeo3xxxxxx
    InstanceChargeType

    string

    Yes

    Metode penagihan target yang akan diterapkan pada instans. Nilai yang valid:

    PrePaid: Mengonversi instans pay-as-you-go tingkat instans menjadi instans berlangganan (PrePaid).

    PostPaid: Mengonversi instans berlangganan (PrePaid) menjadi instans pay-as-you-go tingkat instans (nilai default).

    PostPaid
    AutoRenew

    boolean

    No

    Apakah akan mengaktifkan perpanjangan otomatis saat mengonversi instans pay-as-you-go tingkat instans menjadi berlangganan. Nilai yang valid:

    true: Aktifkan perpanjangan otomatis.

    false: Jangan aktifkan perpanjangan otomatis (nilai default).

    false
    Period

    string

    No

    Durasi langganan saat mengonversi instans pay-as-you-go tingkat instans menjadi berlangganan. Bidang ini wajib diisi dalam skenario ini. Nilai yang valid:

    Jika PeriodUnit diatur ke Day, maka Period hanya dapat diatur ke 3.

    Jika PeriodUnit diatur ke Month, maka Period dapat diatur ke 1-9 atau 12.

    1
    PeriodUnit

    string

    No

    Unit durasi yang digunakan untuk membeli sumber daya saat mengonversi instans pay-as-you-go tingkat instans menjadi berlangganan. Bidang ini wajib diisi dalam skenario ini. Nilai yang valid:

    Month: Beli per bulan.

    Day: Beli per hari.

    Month
    IncludeDataDisks

    boolean

    No

    Apakah akan mengonversi semua data disk pay-as-you-go yang dibuat bersama instans menjadi data disk berlangganan saat mengonversi instans pay-as-you-go tingkat instans menjadi berlangganan. Nilai yang valid:

    true: Ya.

    false: Tidak (nilai default).

    true
    AutoPay

    boolean

    No

    Apakah akan mengaktifkan pembayaran otomatis saat mengonversi instans pay-as-you-go tingkat instans menjadi berlangganan. Nilai yang valid:

    true: Aktifkan pembayaran otomatis. Pastikan saldo akun Anda mencukupi.

    false: Hanya membuat pesanan tanpa memotong biaya (nilai default).

    false
    BillingCycle

    string

    No

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons.

    RequestId

    string

    ID permintaan.

    E2CE5821-7A18-5F7B-A18A-1C751B933D2A
    InstanceIds

    array

    Daftar ID instans.

    string

    ID instans.

    i-5xu1chy7ckxxxx
    OrderId

    integer

    ID pesanan yang dihasilkan.

    21522202681****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "E2CE5821-7A18-5F7B-A18A-1C751B933D2A",
  "InstanceIds": [
    "i-5xu1chy7ckxxxx"
  ],
  "OrderId": 0
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 VALIDATE.MODULE.FAILED Required module is not selected.
    400 ens.interface.error Failed to call API.
    400 OrderFailed Order failed, please try again.
    400 SystemUseCouponFailed Failed to use coupon.
    400 SystemUseStoredCardFailed Failed to use stored value card.
    400 System.SystemError system error.
    400 SystemCanRefundCheckFailed The business rule check of the cloud product fails, and this order cannot be refunded.
    400 SystemOtsSystem ots storage error.
    400 SystemQueryImmortalError Failed to call Juxiange.
    400 SystemQueryInstanceInfoFailed Failed to find instance information.
    400 SystemResellerPayCalRefundUnitError Ecological payment channel calculation unsubscribe information error.
    400 SystemSaleValidateFailed Sales Expression Validation System Error.
    400 SystemTransferDeleteOldResourceFailed Failed to delete the transferred instance in the transfer order.
    400 SystemUnSupportOperationType Unsupported operation type.
    400 RiskRiskControlRejection Risk Control Rejection.
    400 AuthRamAuthFailed ram sub-account authentication failed.
    400 CommodityInvalidComponent The module you purchased is illegal, please re-select.
    400 CommodityInvalidItemCode Specification code illegal.
    400 PriceHsfTimeoutError Time out when calling the request for quotation interface.
    400 PricePatingConfigError Inquiry related goods configuration error.
    400 PricePricingPlanResultNotFound Pricing plan price result not found.
    400 PriceRatingGetRatingpricingPlan Obtain a valid pricing plan exception.
    400 OrderAbnormalResourceStatusForRenew Invalid resource status for renewal.
    400 OrderAccountStatusIllegal Illegal account status.
    400 OrderArrearage User Arrears.
    400 OrderBidUserOrderForbidden Bid users cannot buy on the official website.
    400 OrderCaptureFailed The paid order of the instance has not been deducted successfully.
    400 OrderExistsReleasedInstances There are already released instances.
    400 OrderGroupOrderSizeOverflow The quantity of bound combined payment order exceeds the limit.
    400 OrderHomeCurrencyCanNotDowngrade Users in current currency cannot downgrade.
    400 OrderHomeCurrencyCanNotUpgradeByValueTransfer Users of current currency cannot upgrade through residual value transfer.
    400 OrderInstanceHasInactiveChange Instances exist temporary upgrade.
    400 OrderInstHasUnpaidOrder The instance has an unpaid order.
    400 OrderInstHasUnsettledBills The instance has an unsettled bill.
    400 OrderLatestOrderIsHandling Recent order is being processed, please try again later.
    400 OrderMainOrderSizeOverflow The quantity of the main order exceeds the limit.
    400 OrderMissingModuleInfoError Module parameter not specified.
    400 OrderNoRealNameAuthentication No real-name authentication.
    400 OrderNotFound The specified order information is not found.
    400 OrderOpend You have activated this product.
    400 OrderPeriodInvalid Illegal order cycle.
    400 OrderQuantityInvalid Illegal quantity ordered.
    400 OrderQueryInstanceError Query instance error.
    400 OrderQueryInstanceNotExists Instance data does not exist.
    400 OrderQueryOrderExchangeRateFail Failed to query order exchange rate information.
    400 OrderQueryUserSettleInfoFail Failed to query user settlement information.
    400 OrderQuotaExceeded Quantity exceeds limit.
    400 OrderSysConstraintInvalid System constraint check failed.
    400 OrderTradeCompleteSettleInfoFail Failed to complete the order settlement currency amount information.
    400 TradeTradeOrderAfterPayCheckError You have already paid for the subsequent orders of this instance. The current order has been automatically voided and you cannot pay any more.
    400 PurchaseExistRenewchangeProd There is a renewal change subscription that has not yet taken effect.
    400 PurchaseExistToBeValidProdRuleError Currently, there are temporary orders that are not in effect, and the upgrade operation cannot be performed.
    400 PurchaseExistToBeValidRenewChangeProdRuleError Currently, there is an uneffective renewal change subscription, and temporary upgrade operation cannot be performed.
    400 PurchaseExistValidProdRuleError Currently, there is a temporary order in effect, and operations such as upgrade/downgrade/expansion/pre-transfer cannot be performed.
    400 ProductInstanceReleased Instance released.
    400 ProductInstanceTypeNotSupported The instance type is not supported.
    400 PatRiskRejectForTradeData Payment order problem leads to risk control rejection.
    400 PayAccountBookNotExist There is no insufficient account balance in the account book, please retry after recharging.
    400 PayAmountLimitExceeded Payment limit exceeded, please resubmit.
    400 PayBeforePayRiskRuleValidateFailed The payment was blocked by risk control, and the payment failed.
    400 PayCounponNotExist Counpon does not exist.
    400 PayCouponAmountNotEnough Insufficient voucher balance or expired.
    400 PayCouponNotMeetConsumptionRule The coupon does not meet the conditions for use.
    400 PayCurrencyInconsistency Currency mismatch.
    400 PayCurrencyNotSupported Currency not supported.
    400 PayForbiddenNoReasonFefund Banned five days no reason refund.
    400 PayHsfTimeoutError Call payment system timeout.
    400 PayInsufficientBalance Account balance is insufficient, please recharge and try again.
    400 PayInvalidCreditCard Invalid credit card.
    400 PayInvalidPayMethod Illegal payment method.
    400 PayMegrePayOrderHasThanOneChagreChannel Payment failed, please retry or submit work order feedback.
    400 PayNoCreditCard No valid payment method, please check the payment method and try again.
    400 PayOrderPayTimeInvalid Order effective time is invalid.
    400 PayPartRefundNotSupport Not Capture, no partial refund.
    400 PayPayChannelPayOrderInvalidStatus Illegal status of payment order in payment channel.
    400 PayPayChannelPayOrderNotExist Payment channel payment order does not exist.
    400 PayPayerAccountIllegal Illegal payment account.
    400 PayPayFailedParentRelationchanged If the financial custody relationship changes, please void the order and place a new order for payment.
    400 PayPayForbidUserCoupon Coupon prohibited for orders.
    400 PayQueryAvailableAmountFailed Failed to query user availability, please try again later.
    400 PayQueryAvailableEnduserAmountFailed Failed to query the availability of quota direct customer main user, please try again later.
    400 PayQueryParentRelationshipFailed Failed to query current user hosting relationship, please try again later.
    400 PayQueryPayChangeChannelNotEqual Multi-order payment channels are inconsistent, please check whether the original order data payment channel is correct.
    400 PayRefundFailed Accumulated refund amount exceeds payment order amount.
    400 PayResellerPayGetUrlError Order payment failed, please try again later.
    400 PayRiskRejectForPayerAccount Payment account problem leads to risk control rejection.
    400 PayStoredCardNotExist Stored value card does not exist.
    400 PaySystemError Error calling payment system.
    400 PayTaxCalcFailed Failed to get user tax address.
    400 PayWithholdingAgreementIllegal Withholding Agreement Status Illegal.
    400 AccountAliyunAccountFrozen Alibaba Cloud account is frozen.
    400 AccountAliyunAccountNotExist Alibaba Cloud account does not exist.
    400 RefundRefundInstanceNotFound Unable to find instance information.
    400 RefundRefundNoValidProd Refund is not available to unsubscribe.
    400 RefundRefundParamInvalid Abnormal refund parameter.
    400 RefundRefundQueryOrderFail Failed to query order for refund field.
    400 SystemConcurrentOperate Concurrent operation causes failure.
    400 PricePricingPlanNotFound Pricing plan tree not found.
    400 OrderInstanceHasTempUpgrade Instances exist temporary upgrade.
    400 PayQueryParentRelationchangedFailed The financial custody relationship may change, please refresh and pay again.
    400 PayforCreditPayInsufficientBalance Insufficient quota, please contact your channel partner to increase the quota.
    400 PayforAccountMoneyValidateError The available amount of your channel partner's account is insufficient, please contact your channel partner to recharge in time.
    400 BasicInfoUncompleted You have not completed your basic personal information. Please complete the information and re-operate it.
    400 NoPermission Permission denied.
    400 InvalidParameter.%s The specified field %s invalid. Please check it again.
    400 IncorrectInstanceStatus The current status of the instance does not support this operation.
    400 InstanceIdNotFound The input parameter instancdId that is not found.
    400 EnsPostOpenError Commodity opening failed.
    400 EnsServiceArrearage User account is arrearage.
    400 InvalidDeletionAppointmentNotSupported The scheduled release time of the current instance is set to prohibit this operation.
    400 InvalidDeletionProtectionNotSupported The current instance has release protection enabled. This operation is not allowed.
    400 InstanceForbidOperate There are currently uncompleted operations on the instance. Please wait for the instance renewal, configuration change, or payment type conversion to be completed before retrying.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.