全部產品
Search

搜尋本產品

    Elastic Compute Service：ModifyInstanceChargeType

    文件中心

    Elastic Compute Service：ModifyInstanceChargeType

    更新時間：Sep 24, 2026

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

    介面說明

    使用須知

    • 請確保在使用該介面前，您已充分瞭解雲端伺服器 ECS 的包年包月、按量付費等計費方式和價格。

    • 請確保目標執行個體的狀態為執行中（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 執行個體的宿主機為專屬宿主機 DDH，則取值範圍不能超過專屬宿主機的訂閱時長。取值範圍：

    `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

    FeeOfInstances

    object

    FeeOfInstance

    array<object>

    訂單費用詳情。

    object

    Currency

    string

    帳單費用貨幣單位。

    中國站：CNY。

    國際站：USD。

    CNY
    Fee

    string

    費用數值。

    0
    InstanceId

    string

    執行個體 ID。

    i-bp67acfmxazb4p****
    OrderId

    string

    訂單 ID。僅在付費方式修改為預付費時傳回。

    20413515388****
    RequestId

    string

    請求 ID。

    B61C08E5-403A-46A2-96C1-F7B1216DB10C

    樣本

    正常返回樣本

    JSON格式

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

    錯誤碼

    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 參數無效。
    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 指定的 SystemDisk.Size 不合法。
    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. 指定的PrivatePoolOptions.MatchCriteria參數與私有池不匹配。
    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. 指定的執行個體已欠費。
    400 LastTokenProcessing The last token request is processing 正在處理上一條 Token 請求，請您稍後再試。
    400 Account.NotSupported Your account is not support ordering product in marketplace, please change other accounts. 該訂單涉及雲端市場第三方服務商商品，目前不支援代銷客戶購買，如需購買，建議您更換帳號後重試。如還有疑問，可以聯絡您關聯的代銷夥伴了解相關業務規則，謝謝！
    500 InternalError The request processing has failed due to some unknown error, exception or failure. 內部錯誤，請重試。
    500 InvalidInstanceType.ValueUnauthorized The specified InstanceType is not authorized.
    500 InvalidOperation.RefundFailed Failed to refund. Please try again or submit a support ticket. 退款失敗。
    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. 您在當前地域選擇的執行個體規格所要建立的台數超出系統限額，或者全執行個體規格vCPU配額超出系統限額，您可以前往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.
    409 InvalidOperation.Conflict Request was denied due to conflict with a previous request, please try again later. 由於任務衝突，不允許此操作。

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

    變更歷史

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