本章节介绍创建实例的请求参数、响应参数和示例说明。

开通流程

请求参数

字段	类型	是否必选	描述
action	string	true	CreateAppInstance
user_id	string	true	用户唯一标识
app_id	string	true	应用唯一id
spec	string	true	spec 定价规格名称（base64 编码）
spec_package	string	true	spec_package 定价规格套餐（base64 编码）
period	string	true	定价-套餐有效期 参数组成：值_时间单位 例如： 1_year 1_day 1_month
cloud_info	string	true	当前云环境访问域名，接入方后续对接会用到。 json 字符串格式，通过 base64 编码传输。 # 以下为青云公有云服务地址 { "sso_server": "https://account.qingcloud.com", "api_server": "https://api.qingcloud.com" } 参数说明： sso_server：青云 SSO 服务访问地址。 api_server：青云平台 API 访问地址。 注意： 接入系统所有对接操作都需要从这个参数重获取访问地址。
debug	boolean	false	如果该值为 true，则表示当前实例用于调试。不会进行实例的计费操作。
order_id	string	true	订单 ID，可用于接口重试时的去重处理。
time_stamp	string	true	时间戳，格式：ISO8601 示例：2021-06-22T09:15:03Z URL 编码后：2021-06-22T09%3A15%3A03Z
signature	String	true	签名

响应参数

参数名称	是否必选	类型	key 名称	说明
success	true	boolean	-	操作成功
message	false	string	-	操作不成功时返回的消息
instanceId	true	string	-	服务商为用户创建的实例唯一 id （可以理解为租户 id）。 如果用户多次创建应返回不同的 id。 长度最长 128位 不能重复
appInfo	false	JSON	frontEnd url：前台访问地址 username：前台账号 password：前台密码 admin url：后台访问地址 username：管理账号 password：管理密码 authUrl：免登接口地址	-

示例说明

// 参数：
{
  "user_id" :  "usr-xx1xx" ,
  "signature":  "puc6rZedSRTUTgSWoIX63eYb9ZM3QRuBWS1Jows9I5E=" ,
  "action" :  "CreateAppInstance" ,
  "time_stamp" :  "2021-06-23T07:26:13Z" ,
  "spec" :  "5aWX6aSQ5ZCN56ewMQ==" ,
  "cloud_info" :  "eyJhcGlfc2VydmVyIjogImFwaS5xaW5nY2xvdWQuY29tOjc3NzciLCAic3NvX3NlcnZlciI6ICJzc28ucWluZ2Nsb3VkLmNvbSJ9" ,
  "period" :  "1_day" ,
  "order_id" :  "appor-xxxxx",
  "app_id" :  "app-xxxxx"
}  

GET请求：  
http://127.0.0.1/test/spi?user_id=usr-xx1xx&signature=puc6rZedSRTUTgSWoIX63eYb9ZM3QRuBWS1Jows9I5E%3D&action=CreateAppInstance&time_stamp=2021-06-23T07%3A26%3A13Z&spec=5aWX6aSQ5ZCN56ewMQ%3D%3D&cloud_info=eyJhcGlfc2VydmVyIjogImFwaS5xaW5nY2xvdWQuY29tOjc3NzciLCAic3NvX3NlcnZlciI6ICJzc28ucWluZ2Nsb3VkLmNvbSJ9&period=1_day&app_id=app-xxxxx

// 响应成功： 
{
	"instanceId": "i-gy72h4eo",
	"message": null,
	"appInfo": {
		"admin": {
			"url": "https://admin.saas.com",
			"username": "ad-gggiz28bn5",
			"password": "o0u9zsbvxe"
		},
		"authUrl": "https://auth.saas.com",
		"frontEnd": {
			"url": "https://console.saas.com",
			"username": "fn-g159wmll",
			"password": "b0bn5qzy"
		}
	},
	"success": true
}

// 响应失败：
{
	"success": false,
	"message": "开通失败"
}