检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
基础功能 Sdk::Init Sdk::RegisterEventRecall Sdk::ShutOut 父主题: 改造功能模块说明
基础接口描述 创建实例 查询实例信息 更新实例 更新实例状态 释放实例 实例升级 父主题: SaaS类商品接入指南 V2.0(新商品上架)
基础接口描述 新购商品 商品续费 商品过期 商品资源释放 商品升级 资源状态变更 查询实例信息 父主题: 接口描述
不支持按不同版本、不同场景、不同模块在云商店中发布多个商品,常见场景及案例如下: 某商品有多个不同的版本,如基础版、高级版、旗舰版、豪华版等,应按多规格或多SKU规格的形式发布成一个商品; 某商品中的某个版本有多个不同的功能,如数据治理、数据集成、数据共享等,应按多规格或多SKU规格的形式发布成为一个商品
商品续费 接口说明 按周期售卖的商品,商家必须实现续费接口生产开发。 客户续费下单或试用商品转正后,云商店将调用该接口请求商家执行业务延期,商家接口需要执行将到期日进行更新,并返回通知云商店。 商家需要保障续费接口通畅,将业务进行延期,如续费失败,将可能导致用户的业务被释放的风险。
实例升级 接口说明 用户对已购买的资源进行升级,升级订单付款成功后,云商店调用该接口请求商家升级用户购买的资源,商家接口需要执行资源升级,并记录用户升级后的产品数据。 商品升级流程如下图所示: 请求方法:POST Body参数 参数 是否必选 类型 取值范围 说明 activity
创建实例 接口说明 客户购买商品并付款成功,云商店将调用本接口通知商家创建实例 商家需要返回此订单的唯一ID(instanceId)。建议此ID直接使用该订单首次请求时云商店传入的businessId,以确保instanceId的唯一性。 在正常购买场景中,请不要阻塞此接口,如果耗时较长
枚举属性的枚举值指规格定价中该枚举属性下的计费项,如:软件分版本销售,则枚举属性“软件版本”下设置枚举值为:基础版、专业版、旗舰版。 点击“下一步”,生成SKU,确认无误后点击“生成SKU”。
用户数+购买时长3个维度进行定价,则软件版本是枚举属性名称,用户数是数量属性名称,购买时长按月、按年是计费方式;需在“SKU属性管理”中新增枚举属性命名为“软件版本”,新增数量属性命名为“用户数”,发布规格时选择这2个属性,然后设置数量属性的范围、步长,设置枚举属性下的枚举值为:基础版
Sdk::Init 场景描述 初始化函数,由工业软件调用,且必须首先调用。此函数可与ISCDesk建立连接,并执行相关初始化处理。 涉及接口 Sdk::Init 调用示例 invoker.IscdeskFactory()->Init(); 父主题: 基础功能
商品过期 接口说明 客户购买的商品过期时,云商店调用该接口,商家接到该通知以后应该将指定的实例冻结。 针对过期场景接口调用失败的情况,云商店会持续调用1小时后停止调用,“卖家中心>生产接口消息”中可查询接口“异常信息”,请在修复接口异常后,通知云商店partner@huaweicloud.com
查询实例信息 接口说明 商家创建完资源后,云商店根据instanceId查询资源实例的信息。 查询实例信息流程如下图所示: 请求方法:POST Body参数 参数 是否必选 类型 取值范围 说明 activity M String 20 接口请求标识,用于区分接口请求场景。 升级场景取值
查询实例信息 接口说明 按次或包周期商品非必选调测接口,按需和按需套餐包商品必选。 用户在购买了商品后需要查询所购买的商品实例信息,对于按需商品,还需要实时返回当前用户的按需用量信息 。 用户如果购买了按需套餐包,还需要通过这个接口返回套餐包的用量信息。 查询实例信息流程如下图所示
商品资源释放 接口说明 云商店将在释放客户购买的商品时调用该接口,商家接收到该通知以后可以删除指定的实例。 当客户已购买的商品到期不续订且超过保留期、或申请退订商品成功时,将释放客户购买的商品资源。 针对释放场景接口调用失败的情况,云商店会持续调用1小时后停止调用,“卖家中心>生产接口消息
更新实例 接口说明 按周期售卖的商品,用户试用转正、续费、退续费后,云商店调用该接口,更新实例的到期日期。 用户进行商品转正、续费下单或退订续费周期后,云商店将调用该接口请求商家执行业务变更,商家接口需要执行将到期日进行更新,并返回通知云商店。 商家需要保障更新实例接口通畅,如调用失败
资源状态变更 接口说明 用户购买按周期计费商品后,对应的资源实例到期、违规等场景,云商店调用该接口,商家将指定的实例冻结。 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件及时处理接口异常。 云商店会对接口异常的情况做监控,如SaaS商品频繁出现因接口异常的情况
更新实例状态 接口说明 用户购买按周期计费商品后,对应的资源实例到期、违规等场景,云商店调用该接口,商家将指定的实例冻结。 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件及时处理接口异常。 云商店会对接口异常的情况做监控,如SaaS商品频繁出现因接口异常的情况
释放实例 接口说明 用户释放购买产品的实例时(到期不续费、退订等场景),云商店调用该接口,商家将对应的实例进行删除。 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件及时处理接口异常。 云商店会对接口异常的情况做监控,如SaaS商品频繁出现因接口异常的情况
Sdk::RegisterEventRecall 场景描述 注册事件接收函数。此函数由工业软件调用,使用此函数可注册工业软件接收事件的回调函数。当前SDK会产生心跳回复事件、打开云端文件事件、保存结果回复事件、升级事件、ISCDesk客户端关闭事件、License验证事件,当SDK
Sdk::ShutOut 场景描述 退出函数,由工业软件调用。工业软件关闭之前可主动调用此函数,断开与ISCDesk的连接,并释放资源。 涉及接口 Sdk::ShutOut 调用示例 invoker->ShutOut() 父主题: 基础功能