续订实例

接口说明

续订包周期实例。

使用须知：

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

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

3. 一体化续订会将符合续订条件的关联资源一并续订，请务必提前确认，不符合续订条件的资源会在接口返参中体现。

注意事项：

1. 只支持操作包年包月实例，不支持操作按量付费实例。

2. 续订时请确保账户余额充足。

3. 包月转包年、包月转按量、按量转包年、按量转包月暂不支持通过接口续订，仅包年实例可选择到期以包月或按量的计费方式进行续订。

4. 续订生效前不能再次续订。

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

6. 续订包年资费，最多支持续订5年；续订包月资费，最多支持续订60个月。

7. 麒麟等收费镜像的实例不支持续订。

8. 如有以下情况，不支持一体化续订：

   • 实例及关联资源存在续订未生效、变更未生效订单。

   • 实例及关联资源存在在途订单。

   • 实例及关联资源订购周期为按量或者订购周期不一致（如实例包月，硬盘包年）。

   • IPv6共享带宽暂不支持一体化续订。

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

URL

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

请求参数

请求示例

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

{
	"chargeMode":"TURN_MONTH",
	"duration":2,
	"instanceId":"72dse2f9-23e5-4fca-xs3a-4f416d5188ae",
	"relatedResourcesOption":{
		"renewDataVolume":true,
		"renewBandwidth":true
	}
}

返回参数

返回示例

{
	"requestId":"reqId-009623s4a556322e0d840-a7716046-1",
	"state":"OK",
	"body":{
		"orderId":"MOP-O-24024375637619",
		"orderExts":[
			{
				"subOrderId":"MOP-T-25040394597918",
				"orderExtType":"vm"
			},
			{
				"subOrderId":"MOP-T-25040394597918",
				"orderExtType":"highPerformance"
			}
		],
		"paymentInfo":null,
		"procedureCode":"POSTPAID",
		"resourceRemind":null,
		"unrenewedResources":[
			{
				"resourceId":"xxx",
				"resourceType":"ipv6bandwidth",
				"message":"您之前发起过一笔续订操作，还未过渡到下一个生效周期，暂时不能发起续订操作"
			}
		]
	}
}