修改一台執行個體上掛載的一塊或最多 16 塊磁碟的計費方式。

描述

使用該介面時,請注意:

  • 訂用帳戶磁碟轉換為隨用隨付磁碟時,適用於訂用帳戶執行個體上掛載的訂用帳戶雲端碟。
  • 隨用隨付磁碟轉換為訂用帳戶磁碟時,適用於預付費執行個體上掛載的隨用隨付資料盤,或者隨用隨付執行個體上掛載的隨用隨付資料盤。
  • 掛載的執行個體不能為欠費停機狀態。
  • 磁碟每成功修改計費方式一次,5 分鐘內不能再次修改。
  • 更換計費方式後,預設自動扣費。您需要確保賬戶餘額充足,否則會生成異常訂單,此時只能作廢訂單。如果您的賬戶餘額不足,可以將參數 AutoPay 置為 false,此時會生成正常的未支付訂單,您可以登入 ECS 控制台 支付。

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值: ModifyDiskChargeType
DiskIds String 磁碟 ID 列表,一個帶有格式的 Json Array:[“d-xxxxxxxxx”, “d-yyyyyyyyy”, … “d-zzzzzzzzz”],最多支援 16 個 ID,用半形逗號(,)隔開。
InstanceId String 磁碟掛載的執行個體 ID。
RegionId String 執行個體所屬的地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
DiskChargeType String 磁碟計費方式。取值範圍:
  • PrePaid:隨用隨付資料盤轉換為訂用帳戶資料盤。
  • PostPaid:訂用帳戶資料盤轉換為隨用隨付資料盤。
預設值:PrePaid。
DryRun Boolean 是否只預檢。當 DryRun 值為 true 時,只預檢測,不實際的修改付費類型操作。取值範圍:
  • true
  • false
預設值: false
AutoPay Boolean 是否自動支付。取值範圍:
  • true:自動支付。您需要確保賬戶餘額充足,如果賬戶餘額不足會生成異常訂單,只能作廢訂單。
  • false:只生成訂單不扣費。如果您的賬戶餘額不足,會生成正常的未支付訂單,此訂單可登入 ECS 控制台支付。
預設值:true
ClientToken String 用於保證請求的等冪性。由用戶端生成該參數值,要保證在不同請求間唯一。只支援 ASCII 字元,且不能超過 64 個字元。更多詳情,請參閱 如何保證等冪性

返回參數

名稱 類型 描述
OrderId Long 生成的訂單 ID

樣本

請求樣本
https://ecs.aliyuncs.com/?Action=ModifyDiskChargeType
&RegionId=cn-hangzhou
&DiskIds=["d-xxxxx1","d-xxxxx2"]
&InstanceId=i-xxxxx1
&AutoPay=false
&ClientToken=xxxxxxxxxxxxxx
&<公共請求參數>
返回樣本

XML 格式

<ModifyDiskChargeType>
      <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
      <Order>1011111111111111</Order>
</ModifyDiskChargeType>
JSON 格式
{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
    "Order": 1011111111111111,
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
Account.Arrearage Your account has an outstanding payment. 400 您的帳號已經欠費。
IdempotenceParamNotMatch Request uses a client token in a previous request but is not identical to that request. 400 與相同 ClientToken 的請求參數不符合。
InvalidClientToken.ValueNotSupported The ClientToken provided is invalid. 400 ClientToken 參數值不合法,只支援 ASCII 字元。
InvalidInstance.UnpaidOrder The specified instance has unpaid order. 400 當前執行個體存在未支付的訂單。
InvalidInstanceId.Released The specified instance has been released. 400 指定執行個體已被釋放。
OrderCreationFailed Order creation failed, please check your params and try it again later. 400 建立訂單失敗。
Throttling You have made too many requests within a short time; your request is denied due to request throttling. 400 操作過於頻繁,請稍後再試。
ChargeTypeViolation The operation is not permitted due to charge type of the instance. 403 當前執行個體的計費方式不支援此操作。
InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance. 403 賬戶餘額不足。
InvalidPayMethod The specified billing method is invalid. 403 指定的計費方式不存在。
InvalidUser.PassRoleForbidden The RAM user does not have privilege to pass a role. 403 您使用的 RAM 使用者帳號暫不具有 PassRole 的許可權,請聯繫主帳號擁有者 授權 PassRole 許可權。
InvalidDiskIds.NotFound Some of the specified data disks do not exist. 404 磁碟 ID 不存在。
InvalidDiskIds.NotPortable The specified DiskId is not portable. 404 不可卸載磁碟不支援修改磁碟計費方式。
InvalidRegionId.NotFound The RegionId provided does not exist. 404 指定的 RegionId 不存在。
PaymentMethodNotFound No billing method has been registered on the account. 404 您還沒有選擇付款條件。
InternalError The request processing has failed due to some unknown error, exception or failure. 500 內部錯誤。