云服务器内容精选

华为云首页用户手册

SaaS类商品接入指南 V2.0（新商品上架）

云商店-接口说明:接口调用场景（下单）

接口调用场景（下单）创建实例：客户购买商品并付款成功。云商店将调用创建实例接口通知商家根据订单号创建实例。商家系统收到该请求信息，需调用云商店查询订单接口，获取本次订购的相关信息，执行新购对应动作。云商店调用查询实例接口获取实例的相关信息。查询实例信息：查询实例（instanceId）对应的实例信息云商店在获取到创建实例接口返回的实例id（instanceId）后会不断轮询查询实例信息接口，直到商家成功返回实例信息。用户在云商店"已购买服务--查询资源信息"时，云商店会同步调用商家的查询实例信息接口，对用户展示。更新实例：客户试用转正、续费、退续费。云商店将调用更新实例接口，通知商家系统对相应资源变更过期时间，商家本地系统需执行相应动作，并将执行结果返回给云商店。更新实例状态：用户资源实例因到期、违规等情况下会对用户的实例进行冻结，同时在用户续费后，或资源解除违规后会对用户的实例进行解锁。云商店将调用更新实例状态接口，通知商家系统对相应资源执行冻结、解冻操作，并将执行结果返回给云商店。用户订单到期后，根据客户等级，有最长15天的资源冻结期，冻结期内资源不可使用，但可以对此订单续费以解冻继续使用，故商家需对SaaS商品设置15天的冻结期，并在冻结期内保留用户数据。释放实例：用户释放购买产品的实例时（到期不续费、退订等场景）。云商店将调用释放实例接口，通知商家系统对相应资源执行释放操作，并将执行结果返回云商店。实例升级：用户对已购买的资源进行升级，升级订单付款成功。云商店将调用实例升级接口，通知商家系统对相应资源执行升级操作。商家系统到该请求信息，需调用云商店查询订单接口，获取本次升级订购的相关信息，执行升级动作，并将执行结果返回给云商店。实例升级流程请参考《商品升级和计费规则》。企业同步用户购买联营SaaS商品后，登录到华为云买家中心控制台，将应用与企业绑定时，云商店调用该接口请求商家同步该企业的租户信息，商家接口需要执行租户同步，保存租户信息，并返回通知云商店。针对企业同步场景接口调用失败的情况，由买家选择是否重试，并用短信或邮件的形式通知商家接口调用失败。商家的服务器在处理接口请求时，需要做好幂等性处理。对于同一个实例，相同的租户要支持多次请求新增，或者删除，多次新增不应产生新的数据，且需要返回成功，如果是删除，多次删除也需要返回成功，不能因已删除返回失败，删除时不需要校验(创建实例)接口产生的实例是否存在。应用同步用户购买联营SaaS类应用后，登录华为云买家中心控制台，将应用与企业绑定时，云商店调用该接口请求商家同步该企业应用的认证信息，商家接口需要执行应用同步，保存应用信息，并返回通知云商店。针对应用同步接口调用失败的情况，由买家选择是否重试，并用短信或邮件的形式通知商家接口调用失败。商家的服务器在处理接口请求时，需要做好幂等性处理。对于同一个实例，相同的租户，相同的应用，要支持多次请求新增，或者删除，多次新增不应产生新的数据，且需要返回成功，如果是删除，多次删除也需要返回成功，不能因已删除返回失败，删除时不需要校验(创建实例)接口产生的实例是否存在。用户授权同步管理员被授权管理某企业后，登录到华为云买家中心控制台，对企业内用户授权该企业已绑定的应用，云商店异步调用该接口请求商家同步该企业应用的用户授权信息，商家接口需要执行授权信息同步，保存用户授权信息，并返回通知云商店。针对用户授权同步场景接口调用失败的情况，由企业管理员选择是否要继续进行同步。并用短信或邮件的形式通知商家接口调用失败。商家的服务器在处理接口请求时，需要做好幂等性处理。对于同一个实例，相同的租户，相同的应用，相同的userName，要支持多次请求新增，或者删除，多次新增不应产生新的数据，且需要返回成功，如果是删除，多次删除也需要返回成功，不能因已删除返回失败，删除时不需要校验(创建实例)接口产生的实例是否存在。部门增量同步管理员被授权管理某企业后，登录到华为云买家中心控制台，对管理的企业执行新建、编辑、删除部门操作时，云商店调用该接口，请求商家同步该企业的组织增量变更；商家接口需要执行增量组织信息同步，保存信息，并返回通知云商店。商家的服务器在处理接口请求时，需要做好幂等性处理。对于同一个实例，相同的租户，相同的orgCode，要支持多次请求新增，或者删除，多次新增不应产生新的数据，且需要返回成功，如果是删除，多次删除也需要返回成功，不能因已删除返回失败，删除时不需要校验(创建实例)接口产生的实例是否存在。部门全量同步用户购买联营SaaS应用后，登录到华为云买家中心控制台，将应用与企业绑定时，云商店调用该接口请求商家同步该企业全量的组织信息，商家接口需要执行全量组织信息同步，保存组织信息，并返回通知云商店。商家的服务器在处理接口请求时，需要做好幂等性处理。对于同一个实例，相同的租户，相同的orgCode，要支持多次请求，多次请求不应产生新的数据，且需要返回成功。

云商店 SaaS类商品接入指南 V2.0（新商品上架）
云商店-调用结果码说明

调用结果码说明模块结果码结果码说明公共 000000 成功 000001 鉴权失败 000002 请求参数不合法 000003 实例ID不存在（商品续费、过期、资源释放接口可能返回） 000004 请求处理中 000005 其它服务内部错误创建实例 000100 无可用实例资源分配 000101 Mobile number not specified or already exists//手机号为空或重复 000102 Email address is not specified or already exists//邮箱号为空或重复 000103 Product already purchased//该商品不可重复购买 000104 Internal service error//该商品内部服务异常 000105 Account has already subscribed to benefits//该账号已购买权益，无法再开通 000106 Product resources sold out.//该商品资源已售罄 000107 SaaS email domain already exists.//该SaaS邮箱域名重复父主题： SaaS类商品接入指南 V2.0（新商品上架）

云商店 SaaS类商品接入指南 V2.0（新商品上架）