检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
接口请求标识,用于区分接口请求场景。 新购场景取值:newInstance customerId M String 100 客户在华为云注册账号的唯一标识。 customerName M String 64 客户在华为云注册的账户名。 userId O String 64 客户以IAM用户认证方式登录时对应子用户的唯一标识。
释放实例 接口说明 用户释放购买产品的实例时(到期不续费、退订等场景),云商店调用该接口,商家将对应的实例进行删除。 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件及时处理接口异常。 云商店会对接口异常的情况做监控,如商品频繁出现因接口异常的情况,云商店将对该商品做下架处理。
代金券使用规则 云商店代金券(满减券)由商家发放,商家发放代金券时指定适用产品或者具体的产品规格,适用产品范围为该商家在云商店上架的产品。除此之外,注明“不可用于特价套餐”或“不可与促销折扣同享”的代金券不适用于活动打折商品。具体使用规则如下: 使用规则 代金券规格 活动类代金券
更新实例 接口说明 按周期售卖的商品,用户试用转正、续费、退续费后,云商店调用该接口,更新实例的到期日期。 客户商品转正、续费下单或退订续费周期后,云商店将调用该接口请求商家执行业务变更,商家接口需要执行将到期日进行更新,并返回通知云商店。 商家需要保障更新实例接口通畅,如调用失败,将可能导致用户的业务被释放的风险。
创建实例 接口说明 客户购买商品并付款成功,云商店将调用本接口通知商家创建实例。 商家需要返回此订单的唯一ID(instanceId)。建议此ID直接使用该订单首次请求时云商店传入的businessId,以确保instanceId的唯一性。 在正常购买场景中,请不要阻塞此接口,如
解析消息响应 在接收和解释请求消息后,服务返回一个HTTP响应消息。 响应也是由三个部分组成,分别是:状态行、消息报头、响应正文。 状态行 状态行格式如下: HTTP-Version Status-Code Reason-Phrase CRLF HTTP-Version:表示服务器HTTP协议的版本号。
APIGW网关错误码 APIGW网关错误码请参考《错误码》。 父主题: 云商店开放接口指南
更新实例状态 接口说明 用户购买按周期计费商品后,对应的资源实例到期、违规等场景,云商店调用该接口,商家将指定的实例冻结。 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件及时处理接口异常。 云商店会对接口异常的情况做监控,如SaaS商品频繁出现因
异步申请License 接口说明 用户通过云商店向商家申请License。 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件及时处理接口异常。 云商店会对接口异常的情况做监控,如商品频繁出现因接口异常的情况,云商店将对该商品做下架处理。 云商店服务
在线开通License接口示例代码 基于spring boot构建的web工程,包含商家在云商店发布工业软件云联营License类商品时需要对接的生产接口示例代码。 具体操作请参考《在线开通License商品接入示例工程》。 父主题: 在线开通License接入指南
接口调用流程 接口调用的流程为: 获取AK/SK认证 调用接口前,请获取请求认证,并将认证字段填充至下一步中的方法中,进行请示构建,实现请求的认证。 调用接口采用AK/SK认证方式。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。
接口的请求消息中增加可选的输入参数。 无。 响应消息增加返回参数 响应消息增加返回对象,原有的返回对象增加属性等。 调用方在解析JSON消息时,需要保证JSON解析代码能够自动适配响应消息体内新增返回对象或返回码对象增加属性的情况。 增加返回码 因为业务场景扩展,接口增加了新的返回码。 调
接口调试 为了保证使用在线开通License类商品接入方式的正确性,云商店为商家在卖家中心搭建了应用接入调试界面。商家可以在此页面调试接口,在5个调用场景(创建实例、更新实例、更新实例状态、释放实例和异步申请License)的正确性。下面以“创建实例”接口为例进行说明。 操作步骤
签名示例工程代码 签名示例工程代码请参考《AK/SK认证》。 父主题: 接口使用方法
接口请求标识,用于区分接口请求场景。 新购场景取值:newInstance customerId M String 100 客户在华为云注册账号的唯一标识。 customerName M String 64 客户在华为云注册的账户名。 userId O String 64 客户以IAM用户认证方式登录时对应子用户的唯一标识。
获取访问密钥ID 进入卖家中心页面。 单击左侧导航的“应用工具 > 密钥管理”,在“密钥管理”页面单击新增密钥ID后,获取访问密钥。 访问密钥用户接口请求的签名验证使用,请妥善保存,谨慎删除。 父主题: 接入准备工作
开放接口示例代码 具体操作请参考《云商店开放接口示例工程》,路径如下: 父主题: 云商店开放接口指南
Sdk::Save 场景描述 保存文件至云端函数,由工业软件调用。工业软件调用此函数可将单文件或装配体保存至云端,并触发“EVENT_SAVE_RESULT”保存结果回复事件,将保存文件结果连同事件一起告知工业软件。 保存单文件时,工业软件将需要保存的单文件路径传送至ISCDes
客户端工业软件改造流程 ISV对客户端工业软件进行改造时,需要根据改造功能模块说明将工业软件接入ISCDesk,并完成应用程序改造。工业软件改造之后,可实现在ISCDesk客户端的静默安装和卸载,以及管理在云、数据在云和计算在云功能。 图1 客户端工业软件改造流程 父主题: 客户端工业软件改造指南
Sdk::Init 场景描述 初始化函数,由工业软件调用,且必须首先调用。此函数可与ISCDesk建立连接,并执行相关初始化处理。 涉及接口 Sdk::Init 调用示例 invoker.IscdeskFactory()->Init(); 父主题: 基础功能