调用UpgradeInstance为指定的轻量应用服务器升级套餐配置。
使用说明
- 仅支持升级为更高配置的套餐。关于套餐的更多信息，请参见计费项。
- 调用该接口升级服务器时，您需要确保您的阿里云账户余额充足，否则会升级失败。
QPS限制
本接口的单用户QPS限制为10次/分钟。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | UpgradeInstance |
系统规定参数。取值：UpgradeInstance。 |
| InstanceId | String | 是 | ace0706b2ac4454d984295a94213**** |
指定的轻量应用服务器的实例ID。 |
| RegionId | String | 是 | cn-hangzhou |
指定的轻量应用服务器所属的地域ID。 |
| PlanId | String | 是 | swas.s2.c2m2s50b4t08 |
升级后的套餐ID。您可以调用ListPlans查询套餐信息。 |
| ClientToken | String | 否 | 123e4567-e89b-12d3-a456-426655440000 |
保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多信息，请参见如何保证幂等性。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 20758A-585D-4A41-A9B2-28DA8F4F**** |
请求ID。 |
示例
请求示例
https://swas.cn-hangzhou.aliyuncs.com/?Action=UpgradeInstance
&InstanceId=ace0706b2ac4454d984295a94213****
&RegionId=cn-hangzhou
&PlanId=swas.s2.c2m2s50b4t08
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&公共请求参数正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<UpgradeInstanceResponse>
<RequestId>20758A-585D-4A41-A9B2-28DA8F4F****</RequestId>
</UpgradeInstanceResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "20758A-585D-4A41-A9B2-28DA8F4F****"
}错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidPlanIdUpgrade.ValueNotSupported | The specification of the specified planId is lower than the current server specification. | 指定的套餐配置低于当前服务器规格。 |
| 403 | PaymentFailed | Payment failed. Please check your account balance. | 支付失败，请检查您的账户余额是否不足。 |
| 403 | InvalidInstance.UnPaidOrder | The specified Instance has an unpaid order. | 您有未支付订单，请支付该类订单后再重新下单。 |
| 404 | InvalidPlanId.NotFound | The specified PlanId does not exist. | 指定的套餐不存在，请您检查套餐ID是否正确。 |
| 404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的实例不存在，请您检查实例ID是否正确。 |
| 500 | InternalError | An error occurred while processing your request. | 内部错误，请重试。如果多次尝试失败，请提交工单。 |
| 500 | NotEnoughUpgradeStock | The upgrade stock is insufficient. | 升级库存不足。 |
访问错误中心查看更多错误码。