ModifyInstanceChargeType - 修改執行個體計費方式 - Elastic Compute Service

本介面用於修改ECS執行個體的計費方式，支援批量修改。

介面說明

使用須知

請確保在使用該介面前，您已充分瞭解的Elastic Compute Service 的訂用帳戶、隨用隨付等計費方式和價格。
請確保目標執行個體的狀態為運行中（Running）或者已停止（Stopped），並且帳號無欠費。
更換計費方式後，預設自動計費。請確保賬戶餘額充足，否則會產生異常訂單，此時只能作廢訂單。如果您的賬戶餘額不足，可以將參數AutoPay置為false，此時會產生正常的未支付訂單，您可以登入 ECS 管理主控台支付。

注意事項

訂用帳戶轉隨用隨付：
訂用帳戶執行個體轉按量執行個體的時候，新計費方式將覆蓋執行個體的整個生命週期。您會收到修改前後的執行個體計費的價格差退款，退還到您的原付款渠道中，已使用的代金券將不退回。
- 退款規則：您在一個月內能自由操作的退款額度有限且不累計，消耗完退款額度後，只能等待次月轉換計費方式。一次轉換計費消耗的退款額度公式為vCPU 數 *（退款天數*24±浮動小時數）。更多資訊，請參見訂用帳戶轉隨用隨付。
隨用隨付轉訂用帳戶：
- 支援將執行個體掛載的所有隨用隨付資料盤同時轉換為訂用帳戶資料盤。
- 如果隨用隨付執行個體已經設定了釋放時間，則不能調用該介面。更多資訊，請參見訂用帳戶轉隨用隨付。
- 若執行個體處於節省停機模式需先啟動執行個體。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ecs:ModifyInstanceChargeType

update

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

無

請求參數

名稱	類型	必填	描述	樣本值
InstanceIds	string	是	執行個體 ID。取值可以由多台執行個體 ID 組成一個 JSON 數組，最多支援 20 個 ID，ID 之間用半形逗號（,）隔開。	["i-bp67acfmxazb4p**","i-bp67acfmxazb4d**"]
RegionId	string	是	執行個體所屬的地區 ID。您可以調用 DescribeRegions 查看最新的阿里雲地區列表。	cn-hangzhou
Period	integer	否	訂用帳戶續約時間長度。如果 ECS 執行個體的宿主機為Dedicated Host DDH，則取值範圍不能超過Dedicated Host的訂閱時間長度。取值範圍： `PeriodUnit=Month`時，`Period`取值：1、2、3、4、5、6、7、8、9、12。	1
PeriodUnit	string	否	續約時間長度的時間單位，即參數`Period`的單位。取值範圍： Month：月。預設值：Month。	Month
IncludeDataDisks	boolean	否	是否將執行個體掛載的所有隨用隨付資料盤一起轉換為訂用帳戶資料盤。 true：是。 false：否。預設值：false。	false
DryRun	boolean	否	是否只預檢此次請求。取值範圍： true：發送檢查請求，不會查詢資源狀況。檢查項包括 AccessKey 是否有效、RAM 使用者的授權情況和是否填寫了必需參數。如果檢查不通過，則返回對應錯誤。如果檢查通過，會返回錯誤碼`DryRunOperation`。 false：發送正常請求，通過檢查後返回 2XX 的 HTTP 狀態代碼並直接查詢資源狀況。預設值：false。	false
AutoPay	boolean	否	是否自動支付。取值範圍： true：自動支付。您需要確保賬戶餘額充足，如果賬戶餘額不足會產生異常訂單，只能作廢訂單。 false：只產生訂單不計費。預設值：true。說明如果您的支付方式餘額不足，可以將參數 AutoPay 設定為 false，此時會產生未支付訂單，您可以登入 ECS 管理主控台自行支付。	false
InstanceChargeType	string	否	執行個體需要修改的目標計費方式。取值範圍： PrePaid：將隨用隨付執行個體轉換為訂用帳戶執行個體。 PostPaid：將訂用帳戶執行個體轉換為隨用隨付執行個體。預設值：PrePaid。	PrePaid
ClientToken	string	否	保證請求等冪性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元，且不能超過 64 個字元。更多資訊，請參見如何保證等冪性。	123e4567-e89b-12d3-a456-426655440000
IsDetailFee	boolean	否	訂用帳戶轉換為隨用隨付時，是否返回訂單費用詳情。取值範圍： true：是。 false：否。預設值：false。	false

返回參數

名稱	類型	描述	樣本值
	object
OrderId	string	訂單 ID。僅在付費方式修改為預付費時返回。	20413515388****
RequestId	string	請求 ID。	B61C08E5-403A-46A2-96C1-F7B1216DB10C
FeeOfInstances	object
FeeOfInstance	array<object>	訂單費用詳情。
	object
InstanceId	string	執行個體 ID。	i-bp67acfmxazb4p****
Currency	string	賬單費用貨幣單位。中國站：CNY。國際站：USD。	CNY
Fee	string	費用數值。	0

樣本

正常返回樣本

JSON格式

{
  "OrderId": "20413515388****",
  "RequestId": "B61C08E5-403A-46A2-96C1-F7B1216DB10C",
  "FeeOfInstances": {
    "FeeOfInstance": [
      {
        "InstanceId": "i-bp67acfmxazb4p****",
        "Currency": "CNY",
        "Fee": "0"
      }
    ]
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	InvalidInstance.UnpaidOrder	%s
400	Throttling	Request was denied due to request throttling, try again later.	請求因資源或帳號維度過於頻繁，請稍後重試。
400	InstanceHasProcessingConvertOrder	%s
400	InvalidParameter.InstanceIds	The specified InstanceIds are invalid.	指定的執行個體無效。
400	InvalidParameter	%s	無效的參數。
400	InvalidStatus.ValueNotSupported	%s	該資源當前的狀態不支援此操作。
400	InvalidInstanceChargeType.ValueNotSupported	%s	暫不支援此付款類型，請核對相關資訊後重試。
400	InvalidSpotStrategy	The specified spotStrategy is not valid.	指定的競價策略參數SpotStrategy不支援此執行個體，或此執行個體的競價策略屬性（Spot執行個體）不支援此操作。
400	ExpiredInstance	The specified instance has expired.	指定的執行個體已到期。
400	InstancesIdQuotaExceed	The maximum number of Instances is exceeded.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	指定的 ClientToken 不合法。
400	InvalidInternetChargeType.ValueNotSupported	%s	暫不支援指定的網路計費方式，請確認相關參數是否正確。
400	ReleaseTimeHaveBeenSet	The specified instance has been set released time.	指定的執行個體已設定釋放時間。
400	QuotaExceed.AfterpayInstance	The maximum number of Pay-As-You-Go instances is exceeded: %s.
400	InvalidParameter.Bandwidth	%s	指定的頻寬無效，請檢查參數是否正確。
400	QuotaExceed.RufundVcpu	The maximum number of refund vcpu is exceeded: %s.
400	InvalidPeriod.UnitMismatch	The specified Period must be correlated with the PeriodUnit.	指定的時間長度必須與 PeriodUnit 關聯。
400	InvalidImageType.NotSupported	%s	指定的鏡像類型無效，請查詢本地區是否支援此鏡像類型。
400	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.
400	InvalidMarketImageChargeType.NotSupport	The specified chargeType of marketImage is unsupported.	暫不支援該市場鏡像的付費類型。
400	InvalidSystemDiskCategory.ValueNotSupported	%s	當前操作不支援此系統磁碟類型。
400	InvalidAccountStatus.PayAmountLimitExceeded	Your account is being restricted, due to no default payment method is set or you has not being authorized.
400	InvalidInstance.NotFoundSystemDisk	The specified instance has no system disk.	指定的執行個體沒有掛載系統硬碟。請確保指定的執行個體已掛載了系統硬碟。您可以調用 DescribeInstances 查詢指定執行個體的資訊。
400	AccountForbidden.ProductCreationLimited	The commodity must be officially operated by Aliyun and in pay-as-you-go billing method.	集團上雲客戶只能購買隨用隨付的 ECS，且不能購買第三方的商品比如由鏡像市場提供的鏡像。請檢查參數，傳入合格參數重試。
400	Invalid.PrivatePoolOptions.MatchCriteria	Target mode does not support this operation.	Target模式不支援本次操作。
400	InvalidPeriod	The specified period is not valid.	指定的時段不合法。
400	DISK_IN_DEDICATED_BLOCK_STORAGE_CLUSTER	The disk in dedicated block storage cluster is not allowed to do this operation.
400	NoPermission.Price	The operation requires price permission. Please either apply for permission from your main account, or set the parameter AutoPay as true.	該操作需要價格許可權。請向您的主賬戶申請許可權，或將參數AutoPay設定為true進行自動支付。
400	NoPermission.Refund	The operation requires refund permission. Please apply for permission from your main account.	該帳號無許可權操作退款，主帳號需要授權退款相關許可權。
400	QuotaExceeded.InternetBandwidth	%s.	您當前帳號下，隨用隨付ECS執行個體的按固定頻寬計費公網頻寬超過了總頻寬配額限制。
400	DiskExpiredOrInArrears	Your account has an overdue payment for the specified instance.	指定的執行個體已欠費。
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	內部錯誤，請重試。
500	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.
403	InvalidInstance.TempBandwidthUpgrade	Cannot switch to Pay-As-You-Go during the period of temporary bandwidth upgrade.	執行個體在臨時頻寬升級期間不能轉換為隨用隨付。
403	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.
403	InstanceType.Offline	%s	執行個體規格因停售、供貨不足等原因，不支援該操作。
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.
403	Account.Arrearage	Your account has an outstanding payment.
403	InvalidParameter.NotMatch	%s	您輸入的參數無效，請檢查參數之間是否衝突。
403	InvalidAction	%s
403	QuotaExceed.PostPaidDisk	Living postPaid disks quota exceeded.	隨用隨付磁碟數量已超出允許數量。
403	ImageNotSupportInstanceType	The specified instanceType is not supported by instance with marketplace image.	指定的市場鏡像不支援該執行個體規格。
403	InvalidInstanceType.PhasedOut	This instanceType is no longer offered.	您指定的執行個體規格已下線不再出售。
403	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.
403	RealNameAuthenticationError	Your account has not passed the real-name authentication yet.	您的阿里雲帳號尚未通過實名認證，請先實名認證後再操作。
403	InvalidOperation.NotSupport	Instance on dedicated host not support modify charge type.
403	QuotaExceed.ElasticQuota	No additional quota is available for the specified ECS instance type.	您在當前地區選擇的執行個體規格所要建立的台數超出系統限額，您可以選擇其他地區、執行個體規格或減少台數重新購買，也可以前往ECS管理主控台或配額中心申請提高限額。
403	PeriodNotSupported.InstanceOnManagedPrivateSpace	The instance on ManagedPrivateSpace is not supported to modify chargeType.
403	UnsupportedIspChargeType	%s	付費類型不支援此帳號的服務提供者（ISP）。
403	InvalidOperation.StoppedModeUnsupported	The specified instance is StopCharging.	無法操作處於節省停機模式的執行個體
404	InvalidInstanceId.NotFound	The specified instanceId does not exist.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。