設定一台或多台預付費執行個體的自動續費狀態。

描述

  • 為了減少您的資源到期維護成本，訂用帳戶 ECS 執行個體可以設定自動續費，自動續費扣款日為執行個體到期前第 9 天，扣費在北京時間 （UTC +8） 08:00:00 開始執行。

  • 如果前一日執行自動扣費失敗，將會繼續下一日定時繼續執行，直到扣費成功或者 9 天之後執行個體到期鎖定。您只需要保證自己的帳號的餘額或者信用額度充足即可。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：ModifyInstanceAutoRenewAttribute
RegionId String 是 執行個體所屬的地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
InstanceId String 是 執行個體 ID。支援批量設定最多 100 個訂用帳戶執行個體，多個執行個體 ID 以英文逗號分隔。
Duration Integer 否 設定執行個體自動續費時長。單位：月，取值：1|2|3|6|12
AutoRenew Boolean 否 設定是否自動續費。取值範圍：
  • True：設定為自動續費類型。
  • False：取消自動續費類型。
預設值： False
RenewalStatus String 否 設定是否不再續費，參數 RenewalStatus 的優先順序高於參數 AutoRenew。如果不傳入參數 RenewalStatus，則預設以參數 AutoRenew為準。取值範圍：
  • AutoRenewal：設定為自動續費。
  • Normal：取消自動續費。
  • NotRenewal：不再續費。傳入該值後，系統不再發送到期提醒，只在到期前第三天發送不續費提醒。不再續費的 ECS 執行個體可以更改成待續費（Noramal） 後，再自行續費或設定為自動續費。

返回參數

全是公共返回參數。參閱 公共參數。

樣本

請求樣本 
https://ecs.aliyuncs.com/?Action=ModifyInstanceAutoRenewAttribute
&RegionId=cn-hangzhou
&InstanceId=i-instance1,i-instance2
&Duration=2
&AutoRenew=True
&<公共請求參數>
返回樣本

XML 格式

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

錯誤碼

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

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
ChargeTypeViolation Pay-As-You-Go instances do not support this operation. 403 此操作不支援隨用隨付執行個體類型。
IncorrectInstanceStatus The current status of the resource does not support this operation. 403 由於執行個體已過期，不支援此操作。
InvalidParameter.Duration The auto renewal duration should be one of the following values: 1|2|3|6|12. 403 指定的續費時長不符合要求，應為 [1,2,3,6,12] 中的一個。
InvalidParameter.InvalidInstanceId The specified instanceId is not valid. 403 指定的 InstanceId 無效。
InvalidParameter.ToManyInstanceIds No more than 100 InstanceIds can be specified. 403 指定的 InstanceId 數量不能大於 100。
MissingParameter.InstanceId InstanceId should not be null. 403 參數 InstanceId 不能為空。