接口描述

接口名称: CreateInstance。

接口功能: 用户购买商品并支付后,云市场将通过实例创建通知接口发送信息至服务商的发货 URL。

请求参数

参数 描述

action

固定值:CreateInstance。

signature

签名。

timestamp

UNIX 时间戳。单位:秒。

order_id

订单ID

qingcloud_uid

青云用户ID

product_code

商品编码。

spec

规格名称。

package

套餐名称。

duration

商品套餐有效期。

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

示例:

  • 1_month

  • 12_month

  • 24_month

debug

是否为调试模式。

取值:

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

  • 0:非调试模式

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

请求示例

query_params

{
  "action": "CreateInstance",
  "order_id": "mord-m80iaibd",
  "qingcloud_uid": "usr-u5JDC3MS",
  "product_code": "prod-yha6rswd",
  "spec": "规格",
  "package": "套餐",
  "duration": "12_month",
  "debug": 1
}

Url 示例

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

https://{url}?action=CreateInstance&debug=1&duration=12_month&order_id=mord-m80iaibd&package=%E5%A5%97%E9%A4%90&product_code=prod-yha6rswd&qingcloud_uid=usr-u5JDC3MS&signature=bpy9g5zCGoWvAJqrbpUrNSy7BU%2F2%2B6SiDhi7lPxy5CY%3D&spec=%E8%A7%84%E6%A0%BC&timestamp=1652254417

响应参数

参数名称 是否必选 类型 key 名称 说明

spiVersion

string

-

SPI 版本。默认为 1。

instanceId

string

-

服务实例 ID。全局唯一,长度最大 128 位。

instanceInfo

json-object

  • frontEndUrl:前台地址

  • adminUrl:管理后台地址

  • username:账号

  • password:密码

服务实例信息。

响应示例

{
  "spiVersion": "1",
  "instanceId": "i-ascggds",
  "instanceInfo": {
    "frontEndUrl": "https://www.saas.com/",
    "adminUrl": "https://www.saas.com/admin",
    "username": "root",
    "password": "root123"
  }
}