设置/取消实例自动续订

接口说明


设置/取消自动续订实例及系统盘,不含关联的数据盘和公网IP/带宽(支持批量)。

使用须知:

  1. 续订实例会涉及资源计费,建议您提前了解云服务器 ECS 的计费方式。

  2. 请妥善保管AccessKey,以防通过接口产生不知情订购资费。

注意事项:

  1. 按量计费实例不支持续订。

  2. 专属宿主机上实例不支持。


推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

URL

POST https://ecloud.10086.cn/api/openapi-instance/v4/modify-auto-renew

请求参数

Body

参数名称
类型
必填
描述
batchModifyAutoRenewReq
BatchModifyAutoRenewReq
是

batchModifyAutoRenewReq

autoRenewReqs
<ModifyAutoRenewReq> array
是

实例批量设置/取消自动续订请求体。

instanceId
string
是

实例ID,可通过查询实例状态列表接口获取。

autoRenew
boolean
是

设置/取消自动续订。取值范围:

  • true:设置自动续订。
  • false:取消自动续订。

请求示例

POST https://ecloud.10086.cn/api/openapi-instance/v4/modify-auto-renew
{
	"autoRenewReqs":[
		{
			"autoRenew":false,
			"instanceId":"42se3721-hf4c-4d14-wek4-1ed8775155f4"
		},
		{
			"autoRenew":true,
			"instanceId":"42se3721-hf4c-4d14-wek4-1ed87751551a"
		}
	]
}

返回参数

返回码:200
OK
参数名称
类型
描述
body
BatchAction«InstanceActionResult»

请求成功时返回的数据。

instanceBatchResult
<InstanceActionResult> array

实例批量操作结果集。

instanceOrderAndOrderExtInfos
<InstanceOrderAndOrderExtInfo> array

批量操作涉及订单返回信息。

orderExts
<OrderExt> array

订单项ID数组。

orderExtType
string

订单类型。vm(实例),highPerformance(高性能型系统盘),performanceOptimization(性能优化型系统盘)。

subOrderId
string

订单项ID。

orderId
string

订单ID。

instanceId
string

实例ID。

result
boolean

操作是否下发成功。

message
string

操作结果信息,失败时返回错误信息,成功时返回空字符串。

errorCode
string

统一错误码。

errorMessage
string

页面国际化错误提示。

errorParams
<string> array

统一错误码的自定义参数。

requestId
string

每个请求的序列号。

state
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)

返回状态码。返回正常:OK,返回错误:ERROR,返回异常:EXCEPTION,需要告警实现的:ALARM,禁止访问:FORBIDDEN。

返回示例

返回码:200
OK
{
	"requestId":"reqId-79aa6022dabc4f2488f4357057169038-7",
	"state":"OK",
	"body":{
		"instanceBatchResult":[
			{
				"instanceId":"42se3721-hf4c-4d14-wek4-1ed8775155f4",
				"result":true,
				"message":""
			},
			{
				"instanceId":"42se3721-hf4c-4d14-wek4-1ed87751551a",
				"result":false,
				"message":"按量计费实例不支持续订"
			}
		]
	}
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。