接口描述

接口名称:UpgradeInstance。

接口功能:用户对已购买的实例进行升级时,付费成功后,云市场将通过升级接口发送消息至服务商的发货 URL。

请求参数

字段 描述

action

固定值:UpgradeInstance。

signature

签名。

timestamp

UNIX 时间戳。单位:秒。

order_id

订单 ID。

instance_id

实例 ID。

spec

规格名称。

package

套餐名称。

duration

商品套餐有效期。

格式:值_时间单位。目前时间单位仅支持月(month)。

示例:

  • 1_month

  • 12_month

  • 24_month

debug

是否为调试模式。

取值:

  • 1:调试模式。调试模式下服务商只需进行数据及资源校验,不需要进行实例相关的操作。

  • 0:非调试模式

实际生产场景调用时,云市场会先采用调试模式调用一次,成功后再进行非调试模式下的调用。

请求示例

query_params

{
  "action": "UpgradeInstance",
  "order_id": "mord-m80iaibd",
  "instance_id": "i-ascggds",
  "spec": "规格",
  "package": "套餐",
  "duration": "12_month",
  "debug": 1
}

Url 示例

需将请求示例里的 {url} 替换为服务商发货地址。

https://{url}?action=UpgradeInstance&debug=1&duration=12_month&instance_id=i-ascggds&order_id=mord-m80iaibd&package=%E5%A5%97%E9%A4%90&signature=qSIgZ9UZRTJxCrzAnl9U2yT2LLrAExxssRUUUz%2FW4YQ%3D&spec=%E8%A7%84%E6%A0%BC&timestamp=1652254417

响应参数

参数名称 是否必选 类型 描述

spiVersion

string

SPI 版本。默认为 1。

success

bool

操作是否成功。

响应示例

{
   "spiVersion": "1",
   "success":true
}