調用RenewInstance，為包年包月實例續費。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求頭

該接口使用公共請求頭，無特殊請求頭。請參見公共請求參數文檔。

請求語法

POST /openapi/instances/[InstanceId]/actions/renew HTTP/1.1

請求參數

名稱 類型 位置 是否必選 示例值 描述
InstanceId String Path 是 es-cn-n6w1o1x0w001c****

實例ID。
clientToken String Query 否 5A2CFF0E-5718-45B5-9D4D-70B350****

用于保證請求的冪等性。由客戶端生成該參數值，要保證在不同請求間唯一，最大不超過64個ASCII字符。

RequestBody

RequestBody中還要填入以下字段，用來指定續費信息。

參數

類型

是否必選

示例值

描述

duration

Integer

是

1

續費時長。如果pricingCycle為Year，可選時長為1~3；如果pricingCycle為Month，可選時長為1~9。

pricingCycle

String

是

Year

續費周期。可選值：Year（按年續費）、Month（按月續費）。

示例如下。


{
    "duration":1,
    "pricingCycle":"Year"
}

返回數據

名稱 類型 示例值 描述
RequestId String F99407AB-2FA9-489E-A259-40CF6DCC****

請求ID。
Result Boolean true

返回結果：

  • true：續費成功
  • false：續費失敗

示例

請求示例

POST /openapi/instances/es-cn-n6w1o1x0w001c****/actions/renew HTTP/1.1
公共請求頭
{
    "duration":1,
    "pricingCycle":"Year"
}

正常返回示例

JSON格式 

{
	"Result": true,
	"RequestId": "4FF74B95-7D01-44B4-8E0D-6E5AB515****"
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 InstanceNotFound The instanceId provided does not exist. 實例找不到，請核對實例狀態。

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