Todos os produtos
Search

Este produto

    ENS:ModifyInstanceChargeType

    Central de documentação

    ENS:ModifyInstanceChargeType

    Última atualização: Aug 14, 2026

    Invoca ModifyInstanceChargeType para converter o método de cobrança de uma ou mais instâncias do Edge Node Service (ENS). Você pode converter entre instâncias pay-as-you-go no nível da instância e instâncias por assinatura. Para instâncias pay-as-you-go no nível da instância, você também pode converter discos em nuvem pay-as-you-go criados com as instâncias em discos em nuvem por assinatura.

    Descrição da operação

    Antes de chamar esta operação, certifique-se de compreender totalmente os métodos de cobrança e os preços do Edge Node Service (ENS).

    A instância de destino deve estar no estado Running ou Stopped e não deve ter pagamentos em atraso para que você possa alterar o método de cobrança.

    Experimente agora

    Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

    Testar

    Autorização RAM

    A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

    • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

    • API: A API que você pode chamar para executar a ação.

    • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

    • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

      • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

      • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

    • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

    • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

    Ação

    Nível de acesso

    Tipo de recurso

    Chave de condição

    Ação dependente

    ens:ModifyInstanceChargeType

    update

    *Instance.

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

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    InstanceIds

    array

    Sim

    A lista de IDs das instâncias.

    string

    Não

    O ID da instância.

    i-5xlrc9wdeo3xxxxxx
    InstanceChargeType

    string

    Sim

    O método de cobrança de destino da instância. Valores válidos:

    Valores válidos:

    • PostPaid :

      pay-as-you-go.

    • PrePaid :

      Assinatura.

    PostPaid
    AutoRenew

    boolean

    Não

    Especifica se a renovação automática deve ser ativada ao converter a instância de pay-as-you-go para assinatura. Valores válidos:

    • true: A renovação automática está ativada.

    • false: A renovação automática não está ativada (padrão).

    false
    Period

    string

    Não

    A duração da assinatura ao converter uma instância pay-as-you-go para assinatura. Este parâmetro é obrigatório neste cenário. Valores válidos:

    Se PeriodUnit estiver definido como Day, Period só poderá ser definido como 3.

    Se PeriodUnit estiver definido como Month, Period poderá ser definido como 1-9 ou 12.

    Valores válidos:

    • 1 :

      1 ciclo de cobrança.

    • 2 :

      2 ciclos de cobrança.

    • 3 :

      3 ciclos de cobrança.

    • 4 :

      4 ciclos de cobrança.

    • 5 :

      5 ciclos de cobrança.

    • 6 :

      6 ciclos de cobrança.

    • 7 :

      7 ciclos de cobrança.

    • 8 :

      8 ciclos de cobrança.

    • 9 :

      9 ciclos de cobrança.

    • 12 :

      12 ciclos de cobrança.

    1
    PeriodUnit

    string

    Não

    A unidade da duração da assinatura ao converter uma instância pay-as-you-go no nível de instância para uma instância de assinatura. Este parâmetro é obrigatório neste cenário. Valores válidos:

    Valores válidos:

    • Month :

      mês.

    • Year :

      Ano.

    • Day :

      Dia.

    Month
    IncludeDataDisks

    boolean

    Não

    Especifica se todos os discos de dados em nuvem pay-as-you-go criados com a instância devem ser convertidos em discos de dados em nuvem por assinatura ao converter uma instância pay-as-you-go no nível da instância em uma instância por assinatura. Valores válidos:

    true
    AutoPay

    boolean

    Não

    Especifica se o pagamento deve ser concluído automaticamente quando você altera o método de cobrança da instância de pay-as-you-go para subscription. Valores válidos:

    true: O pagamento é concluído automaticamente. Certifique-se de que o saldo da sua conta seja suficiente.

    false: Apenas um pedido é gerado, mas nenhum pagamento é realizado. Este é o valor padrão.

    false
    BillingCycle

    string

    Não

    O ciclo de cobrança. Valores válidos: Month, Day e Hour.

    Valores válidos:

    • Month :

      mês.

    • Hour :

      Hora.

    • Day :

      Dia.

    Month

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Esquema da resposta.

    RequestId

    string

    O ID da solicitação.

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

    array

    A lista de IDs das instâncias.

    string

    O ID da instância.

    i-5xu1chy7ckxxxx
    OrderId

    integer

    O ID do pedido gerado.

    21522202681****

    Exemplos

    Resposta de sucesso

    JSON formato

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

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    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.

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.