ModifyInstanceChargeType による ENS インスタンスの課金方法の変更

ModifyInstanceChargeType 操作を呼び出して、1 つ以上の Edge Node Service (ENS) インスタンスの課金方法を変更します。インスタンスを従量課金とサブスクリプションの間で相互に変換できます。従量課金インスタンスの場合、インスタンスと共にプロビジョニングされたクラウドディスクも、従量課金からサブスクリプションに変換できます。

操作説明

この API を呼び出す前に、ENS の課金方法と料金をご理解いただく必要があります。

課金方法を変更するには、対象インスタンスが実行中 (Running) または停止済み (Stopped) の状態であり、かつアカウントに支払い遅延がないことが必要です。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ens:ModifyInstanceChargeType

update

*Instance

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
InstanceIds	array	必須	インスタンス ID のリストです。
	string	任意	インスタンスの ID です。	i-5xlrc9wdeo3xxxxxx
InstanceChargeType	string	必須	インスタンスの変更先の課金方法です。有効な値： `PrePaid`：従量課金インスタンスの課金方法をサブスクリプションに変更します。 `PostPaid` (デフォルト)：サブスクリプションインスタンスの課金方法を従量課金に変更します。	PostPaid
AutoRenew	boolean	任意	インスタンスの自動更新を有効にするかどうかを指定します。このパラメーターは、インスタンスの課金方法を従量課金からサブスクリプションに変更する場合にのみ有効です。有効な値： `true`：自動更新が有効になります。 `false` (デフォルト)：自動更新が無効になります。	false
Period	string	任意	サブスクリプション期間です。このパラメーターは、課金方法を従量課金からサブスクリプションに変更する場合に必要です。このパラメーターの有効な値は、`PeriodUnit` パラメーターによって異なります。 `PeriodUnit` が `Day` に設定されている場合、`Period` の有効な値は `3` です。 `PeriodUnit` が `Month` に設定されている場合、`Period` の有効な値は `1`～`9`、および `12` です。	1
PeriodUnit	string	任意	サブスクリプション期間の単位です。このパラメーターは、インスタンスの課金方法を従量課金からサブスクリプションに変更する場合に必要です。有効な値： `Month` `Day`	Month
IncludeDataDisks	boolean	任意	インスタンスと共に作成されたすべての従量課金データディスクの課金方法をサブスクリプションに変更するかどうかを指定します。このパラメーターは、インスタンスの課金方法を従量課金からサブスクリプションに変更する場合にのみ有効です。有効な値： `true`：データディスクの課金方法がサブスクリプションに変更されます。 `false` (デフォルト)：データディスクの課金方法は変更されません。	true
AutoPay	boolean	任意	自動支払いを有効にするかどうかを指定します。このパラメーターは、インスタンスの課金方法を従量課金からサブスクリプションに変更する場合にのみ有効です。有効な値： `true`：自動支払いが有効になります。アカウントの残高が十分であることを確認してください。 `false` (デフォルト)：注文は生成されますが、支払いは行われません。	false
BillingCycle	string	任意

レスポンスフィールド

フィールド	型	説明	例
	object	応答スキーマです。
RequestId	string	リクエスト ID です。	E2CE5821-7A18-5F7B-A18A-1C751B933D2A
InstanceIds	array	インスタンス ID のリストです。
	string	インスタンス ID です。	i-5xu1chy7ckxxxx
OrderId	integer	生成された注文 ID です。	21522202681****

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
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.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。