文档首页/ 云商店/ 接入指南/ SaaS类商品接入指南V2.0（新商品上架）/ 基础接口描述/ 更新实例状态
更新时间：2024-06-12 GMT+08:00
查看PDF
分享

更新实例状态

接口说明

用户购买按周期计费商品后，对应的资源实例到期、违规等场景，云商店调用该接口，商家将指定的实例冻结。

  • 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知，收到调用失败通知邮件及时处理接口异常。
  • 云商店会对接口异常的情况做监控，如SaaS商品频繁出现因接口异常的情况，云商店将对该商品做下架处理。

更新实例状态流程如下图所示：

请求参数说明请参见下表：

请求消息

请求方法：POST

Body参数

参数

是否必选

类型

取值范围

说明

activity

M

String

32

接口请求标识，用于区分接口请求场景。

更新实例状态场景取值：updateInstanceStatus

instanceId

M

String

64

实例ID

status

M

String

32

变更状态：

  • FREEZE：冻结
  • UNFREEZE：解冻

testFlag

O

String

2

是否为调试请求。

  • 1：调试请求
  • 0：非调试业务

默认取值为“0”。

请求消息示例：

curl -X POST 'https://www.isvwebsite.com/saasproduce?signature=95DD9FA6A8C660C9C7F9CFDE97C42535290919BCA3F78B9A254428A692CDF26E&timestamp=1680509558159&nonce=9F26B85CAEB3A8439221BA293E9250BC5EA689225B523C291EA75CC76B469510' -H 'Accept:application/json' -H 'Content-Type:application/json;charset=utf8' -d'{"activity":"updateInstanceStatus","instanceId":"10e758d0-31ad-4c4b-8f1b-81d03469a10e","status":"FREEZE","testFlag":"1"}'

响应消息

响应参数说明请参见下表：

参数

是否必选

类型

取值范围

说明

resultCode

M

String

6

调用结果码。

具体请参见调用结果码说明。

resultMsg

O

String

255

调用结果描述。

响应消息示例：

{ 
    "resultCode":"000000", 
    "resultMsg":"success." 
}
父主题： 基础接口描述