查询实例信息
接口说明
商家创建完资源后，云商店根据instanceId查询资源实例的信息。
查询实例信息流程如下图所示：
请求消息
请求参数说明请参见下表：
请求方法：POST
Body参数
参数 |
是否必选 |
类型 |
取值范围 |
说明 |
|---|---|---|---|---|
activity |
M |
String |
20 |
接口请求标识，用于区分接口请求场景。 升级场景取值：queryInstance |
instanceId |
M |
String |
100 |
实例ID，支持批量，多个实例批量查询时用逗号分隔，单次最多支持100个实例查询。 |
testFlag |
O |
String |
2 |
是否为调试请求。
默认取值为“0”。 |
请求消息示例：
curl -X POST 'https://www.isvwebsite.com/saasproduce?signature=9C61F188C3C2889C2DD201B00E42041BDCE4751F31E35805DE412969F0A7829C×tamp=1680508237508&nonce=9FB42E04DF4594B1FAA50B304E647AD7154AB9B4F144A65F1168886540A8B24C' -H 'Accept:application/json' -H 'Content-Type:application/json;charset=utf8' -d'{"activity":"queryInstance","instanceId":"10e758d0-31ad-4c4b-8f1b-81d03469a10e","testFlag":"0"}'
响应消息
响应参数说明请参见下表：
参数 |
是否必选 |
类型 |
取值范围 |
说明 |
|---|---|---|---|---|
resultCode |
M |
String |
6 |
调用结果码。 具体请参见调用结果码说明。 |
resultMsg |
O |
String |
255 |
调用结果描述。 |
info |
O |
InstanceInfo[] |
实例详情 |
InstanceInfo数据结构定义如下：
参数 |
是否必选 |
类型及范围 |
取值范围 |
参数说明 |
|---|---|---|---|---|
instanceId |
M |
String |
64 |
实例id |
appInfo |
O |
AppInfo |
N/A |
应用实例信息。 客户购买商品后，商家需要返回登录服务地址（网站地址）或免登地址供客户后续操作。
说明：
SaaS商品必须向客户提供应用使用信息，包括使用地址、账号、密码等。 如可实现通过短信、邮件等其他方式发送使用信息，则接口中允许不响应；否则，必须在接口中返回应用实例信息。 如使用信息不仅包含使用地址及账号密码，可通过如下memo参数灵活返回其他使用信息或使用说明等。 appInfo数据结构定义请参见下表。 |
appInfo数据结构定义如下：
参数 |
是否必选 |
类型及范围 |
取值范围 |
参数说明 |
|---|---|---|---|---|
frontEndUrl |
M |
String |
512 |
前台地址。 客户购买商品后，可以访问的网站地址。 |
adminUrl |
O |
String |
512 |
管理地址。 客户购买商品后，可以访问的管理后台地址。 |
userName |
O |
String |
128 |
管理员帐号。 |
password |
O |
String |
128 |
管理员初始密码。 |
memo |
O |
String |
1024 |
备注。
说明：
如果备注包含中文内容，请将中文转换成unicode编码，例如：“中文”可以转换成“\u4e2d\u6587”。 |
响应消息示例：
{
"resultCode": "000000",
"resultMsg": "success.",
"Info": [
{
"instanceId": "huaweitest123",
"appInfo": {
"frontEndUrl": "https://www.baidu.com",
"userName": "zhangsan123",
"password": "zhangsan123",
"memo": "hvave a test, 测试！"
}
]
}
HTTP Body签名:
Body-Sign: sign_type="HMAC-SHA256", signature= "xxxxxxxxxxxxx" ，详情参考《HTTP Body签名》。
