华为云用户手册

需备份数据 版本升级前，为实现新 云堡垒机 系统中复用数据信息，用户需在系统升级前手动备份系统数据，系统升级完成后再导入备份数据。 针对不同的数据信息，用户需分别进行导出/导入操作，才能完成所有数据的备份。 表1 版本升级需备份数据 数据信息 导出 导入 说明 用户 √ √ 无法导出“用户密码”。升级完成后，可选择重置用户密码。 资源账户 √ √ 为防止资源账户信息丢失，建议单独备份和还原资源账户文件。 审计数据 √ × 审计数据无法重新导入到系统，需全量备份审计数据，主要包括历史会话、会话视频、系统登录日志、系统操作日志、运维报表和系统报表。 “运维报表”和“系统报表”支持文本格式导出。 “历史会话”支持导出MP4格式会话视频。 系统配置 √ √ “系统配置”信息包含全量系统配置数据。 详细系统配置说明请参见配置备份与还原。

解决办法 解决办法一：将应用发布服务器安装的remoteapp组件升级至1.1.8.0及以上版本。 解决办法二：登录应用发布服务器，修改“C:\DevOpsTools\RemoteAPPProxy\Application.ini”文件，修改参数影子账户用户名最大长度max_user_length=20将值改为服务器支持的创建用户长度，例如15。 若您不想通过升级RemoteAppProxy跳板工具的临时处理方法，可登录应用发布服务器修改“C:\DevOpsTools\RemoteAPPProxy\Application.ini”文件，修改参数，关闭影子账户：use_shadow_user=0 是否使用影子账户模式的参数说明： 1:开启 0:关闭

控制策略类型介绍 预防性控制策略：策略主体为SCP服务控制策略，任何在策略中显性拒绝的操作都会被拦截。预防性控制策略在指定OU上生效之后，该OU所有直系子级账号均会继承该策略。 检测性控制策略：策略主体为Config合规规则，不合规的资源配置会被检测发现并反馈给用户，用户可以在资源治理中心服务控制台查看不合规的资源列表。检测性控制策略在指定OU上生效后，该OU所有直系子级账号均会根据规则要求检测不合规配置的发生。

实施类型 必选：这部分策略在开启RGC服务并设置Landing Zone后，便在核心OU和核心账号上强制自动生效，而且无法禁用。 强烈推荐：基于华为云治理最佳实践强烈推荐的合规遵从管控策略，大部分企业用户在云上治理多账号环境时大概率会涉及相关场景和服务，建议Landing Zone搭建完成之后，企业用户自主启用。 可选：企业云上治理过程中，部分企业用户可能会涉及相关控制策略，可以根据具体情况灵活选用相关策略。

使用方法 建议使用手机内重启功能时进行流控。并发重启大量手机可能会导致宿主机负载突然飙升，可能会对其他正常运行的手机产生影响。 通过命令行重启 adb shell reboot 约束：只有uid为0，1000或2000的进程有权限执行reboot命令。 系统APP通过PowerManager接口重启 PowerManager powerManager = getSystemService(PowerManager.class); powerManager.reboot("your reason for reboot"); 约束：只有uid为0，1000的进程有权限调用PowerManager接口。 通过注入长按关机键重启 adb shell input keyevent --longpress KEYCODE_POWER 注入长按关机键后，屏幕会弹出重新启动选项，用户单击按钮后手机重启。 例：不同AOSP版本，按钮UI可能不同，请按实际参考。 图1 重新启动 约束：只有uid为0，1000或2000的进程有权限注入长按关机按键。

注册华为账号 并实名认证 如果您已有一个华为账号，请跳到下一个任务。如果您还没有华为账号，请参考以下步骤创建。 打开https://www.huaweicloud.com/，单击“注册”。 根据提示信息完成注册，详细操作请参见“如何注册华为云管理控制台的用户？”。 注册成功后，系统会自动跳转至您的个人信息界面。 参考“实名认证”完成企业账号实名认证。 当前RGC服务暂不收取费用。但您需要根据使用情况为以下服务付费： SMN 、OBS等。

更多操作 消息模板创建完成后，您还可以对消息模板列表执行表4中的相关操作。 表4 相关操作 操作 说明 编辑消息模板 单击“操作”列的“编辑”。 复制消息模板 单击“操作”列的“复制”。 删除消息模板 删除单条消息模板：单击对应规则“操作”列的“删除”，随后在提示页面单击“确定”即可删除。 删除单条或多条消息模板：勾选对应规则前的复选框，单击“批量删除”，随后在提示页面单击“确定”即可删除。 说明： 删除消息模板前需要先删除消息模板绑定的告警行动规则。 搜索消息模板 在右上角的搜索框中输入模板名称关键字，单击后显示匹配对象。

更多操作 告警行动规则创建完成后，您还可以执行表2中的相关操作。 表2 相关操作 操作 说明 编辑告警行动规则 单击“操作”列的“编辑”。 删除告警行动规则 删除单条规则：单击对应规则“操作”列的“删除”，随后在提示页面单击“确定”即可删除。 删除单条或多条规则：勾选对应规则前的复选框，单击“批量删除”，随后在提示页面单击“确定”即可删除。 说明： 删除告警行动规则前需要先删除该行动规则绑定的告警规则或分组规则。 搜索告警行动规则 在右上角的搜索框中输入规则名称关键字，单击后显示匹配对象。

计费示例 以自定义指标上报量使用场景为例。 下面的价格仅为示例，实际计算请以价格计算器中的价格为准。 假设您有1台服务器，每天自定义上报800百万条指标，则按照计费公式，分3个区间计费，费用计算如下： 0~150（百万条）：0.7*150 150~600（百万条）：0.5*450 600~1200（百万条）：0.35*200 每天费用总计为：0.7*150+0.5*450+0.35*200=400元。

AOM 2.0与AOM 1.0计费对比 表2 AOM 2.0与AOM 1.0计费对比说明 计费项 AOM1.0 AOM2.0 日志 日志读写流量 统一由LTS提供并上报话单，AOM不会双算。 不变 日志索引流量 日志存储空间 监控中心 主机监控 按需计费 基础指标免费，自定义指标收费，按照指标上报量进行计费。 CCI实例监控 按需计费 秒级监控指标数量 按需计费 自定义指标 按需计费 查询指标数据API调用 按需计费 免费 事件和告警总条数 按需计费 免费 指标存储量 7天内免费 15天内免费 数据转储量 免费 按需计费

计费说明 AOM提供按需计费模式，计费项由自定义指标上报量、指标存储时长、数据转储量的费用组成。具体内容如表1所示。 AOM 2.0仅对上报的自定义指标计费。对上报任意数量的基础指标都是免费的，基础指标包括虚机指标、容器指标、Modelarts指标和IoTDA指标。 表1 按需计费组成表 计费项 计费说明 计费公式 自定义指标上报量 自定义指标上报量即采样点数量，采样点数量计算方式遵循开源Prometheus的数据模型。一条采样点数据包含指标名称、Label集合、采样时间时间戳及取值这几个部分，采样点以时间线的方式在逻辑上组织起来。例如，kube_node_status_allocatable_cpu_cores指标监控了Kubernetes集群中每个节点的可分配CPU核心数，假设您的集群中包含3个节点，则采样点分布于3条不同的时间线上。若每个节点的采样周期为15s，则一分钟的时间范围内，上报的采样点数据的总条数为：3*(60/15)=12（条），如下图所示： 会产生自定义指标上报的场景：接入Prometheus后，为什么会产生额外费用？。 0~150（百万条）：0.7元/百万条/天 150~600（百万条）：0.5元/百万条/天 600~1200（百万条）：0.35元/百万条/天 1200以上（百万条）：0.25元/百万条/天 指标存储时长 AOM 2.0默认支持的指标存储时长为15天。15天内免费使用，超过15天则按量累计计费。 0.01元//百万条/天 数据转储量 AOM支持的指标数据转储量，按量累计计费。 0.2元//GB

运维中心工作台介绍 AppStage运维中心工作台如图1所示。 图1 运维中心工作台 AppStage运维中心工作台各模块功能如表1所示。 表1 控制台功能说明 模块标识 功能说明 1 服务列表按钮，可切换运维中心提供的BaaS服务和中间件。 2 单击“工作台”可切换至运维中心工作台。 3 可切换站点，当前仅支持“中国区2CBU生产”站点。 4 可切换自有服务，即在业务控制台创建的产品及服务。 5 可切换专项角色，专项角色可在组织内跨租户进行管理，具备跨租户的管理权限，包括主机管理员（主机运维角色）、DBA（数据库DBA角色）等，如需申请专项角色权限请参见申请权限。 6 单击“文档中心”可查看运维中心相关文档。 7 可单击“变更电子流”，进入“变更电子流”页面，可以查看已创建的电子流，或者新建电子流。 8 个人帐号信息管理，包括如下功能： 审计日志：可查看登录账号在运维中心的所有操作日志，产品管理员可查看对应产品的所有操作日志。 我的信息：可以查看个人信息和已拥有的权限，也可以进行权限申请。 租户管理：“我的租户”页面可以查看在业务控制台创建的组织（租户）、产品、服务和微服务信息。“订阅信息”页面可以查看已订阅的服务信息。 账号管理：如果华为云资源管理账号与AppStage的开租账号不同，可以使用账号管理将华为云账号录入AppStage。 说明： 查看并使用账号管理，需要将“专项角色”切换为“主机管理员”。 9 展示近期已访问的服务和已收藏书签内容，可以单击服务或书签快速访问。 收藏书签的方法：单击页面右侧悬浮菜单中的收藏按钮进行收藏，收藏后该页面可展示在已收藏书签列表。 10 展示已集成的中间件和已订阅的服务，单击服务名称可快速访问对应服务。 11 展示近期告警数据，单击“更多”可进入监控服务页面查看详情数据。 12 展示CPU使用情况，单击“更多”可进入实时监控页面查看详细数据。 13 展示运维中心主要功能介绍。 14 展示近期系统公告内容，可以单击“更多”查看所有公告内容。 15 展示近期系统新特色，可以单击“更多”查看历史特性内容。 16 展示用户统计数据，包括当前在线用户数、昨日访问量和历史总人数。

功能介绍 表1 运维中心功能介绍 服务名称 服务简介 部署服务 基础设施即代码（Infrastructure as code，简称IaC）是一种基于软件开发实践形成的基础设施的自动化方法，它强调一致、可重复的供给和变更系统及其配置。当代码发生变更后，可以进行自动化测试，测试完成后可自动化的应用变更到运行系统中。使用基础设施即代码的方法，可以使用敏捷工程的优秀实践（如测试驱动开发、持续集成、持续发布）可以快速安全的变更基础设施。 部署服务按架构元素（服务）组织资源，软件单元（微服务或函数）作为最小变更单元 ，执行变更的结果围绕服务环境进行资源管理，每个组件可以独立发布版本、独立变更。 监控服务 监控服务（ServiceInsight）是一个面向自有服务和生态开发者的开发和运维SRE（Site Reliability Engineer），围绕故障生命周期，构建开箱即用的，集预防、检测、诊断、恢复、通报和改进于一体的可观测性平台。 演练服务 演练服务（WiseChaos）起始于系统改造，具备基本韧性，引入混沌工程并持续向IT化、自动化、智能化、场景化发展。对混沌工程实践进行全流程、数字化、体系化度量，具备精细化持续运营能力。通过完善工具链实现演练过程可控可视，演练场景可复用，高度自动化，最终实现无人值守演练。 弹性资源服务 弹性资源服务（Elastic Resource Service，简称ERS）提供资源池监控、访问安全控制、任务调度、业务负载弹性伸缩、集群联邦、配额管理和多种K8s扩展等能力，通过统一的对外接口提供业务管理能力，上层业务不再感知下层资源。同时提供Portal可视化管理容器，包括工作负载的管理、配置文件管理和容器WebTerminal。 弹性网络服务 弹性网络服务（Elastic Network Service，简称ENS）通过引入“隔离域”这一网络资源概念，将业务使用的底层网络资源进行封装。 主机管理服务 主机管理服务（VMS）是基于云原生的主机资源管理服务，负责各种类型的主机资源发放/回收/操作、OS管理、密码密钥管理。 父主题： 运维中心简介

操作步骤 在AppStage首页右上区域单击“运营中心”快捷入口，进入运营中心工作台。 在左侧导航栏选择“指标模板库”。 从指标模板库查找所需指标模板，单击选中的模板，当前支持的指标模板如表1所示。 如果指标模板库中未找到所需模板，用户可在“指标管理”界面创建符合业务需要的指标。 表1 指标模板 指标模板名称 描述 注册用户数计算模板（注册用户总数/新增用户数） 用于计算网站或应用的注册用户数量，包括总数和新增用户数。 独立访客数（UV）计算模板（总数/日活） 用于计算网站或应用的独立访客数量，包括总数和日活。日活指当天访问网站或应用的独立访客数量。 新增访客数计算模板（日新增/周新增/月新增） 用于计算网站或应用的新增访客数量，可按日、周、月进行统计。新增访客指首次访问网站或应用的用户。 页面浏览量（PV）计算模板（总数/各页面浏览量） 用于计算网站或应用的页面浏览量，包括总数和各页面的浏览量。 用户停留时长计算模板（应用内人均停留时长/页面人均停留时长/重点页面人均停留时长） 用于计算用户在网站或应用上的停留时长，包括应用内人均停留时长、页面人均停留时长和重点页面人均停留时长。 留存率计算模板（留存率/曝光事件转化率） 用于计算用户在网站或应用上的留存率和曝光事件转化率。留存率指用户在一定时间内仍然使用网站或应用的比例，曝光事件转化率指用户在接触网站或应用后转化为注册或付费用户的比例。 在“模板详情”界面，查看指标模板信息，单击“应用”。 在“应用模板”界面，填写基础配置信息，如表2所示。 表2 基础配置 参数 说明 模板指标 预定义的指标。 数据源 数据源在“数据源”界面配置，单击“选择数据源”关联数据源。 请校验数据字段中的映射关系，如果不匹配可能会导致后续的模板应用出现异常或错误。 单击“确定”，完成指标模板应用配置。

问题描述 启动 SMS -Agent时，出现如下提示： Linux系统，提示“SMS.0502: Source server registration failed. Cause: Current quota is not enough, please use MgC.” Windows py2系统，提示“SMS.0502: Source server registration failed. Cause: Current quota is not enough, please use MgC.” Windows py3系统，提示“注册源端失败，错误原因：Current quota is not enough, please use MgC.”

接入流程 工业软件云License联营商品接入云商店的流程如下图所示： 图1 工业软件云License联营商品接入云商店流程 流程说明如下： 申请入驻云商店，成为商家。 云商店运营人员审核公司的资质信息。 根据工业软件云平台的商品接入规范进行应用改造。 准备生产接口服务器，根据本文开发生产接口。 在卖家中心申请访问密钥。 将开发好的生产接口地址绑定访问密钥、并调测成功保存。 调测云商店查询订单、字符串/文件流上传接口。 在卖家中心发布应用资产。 工业软件云平台运营在海顿平台测试应用资产。 云商店运营审核应用资产上架。 在卖家中心申请联营认证。 云商店运营审核联营认证。 在卖家中心申请发布在线开通License联营商品。 云商店运营审核联营商品上架。 运营审核通过后商品上架成功，并在卖家中心自助管理生产接口通知消息。 父主题： 联营License类商品接入指南

概念介绍 ISCDesk ISCDesk（Industrial Software Cloud Desktop），工业软件 云桌面 工具管理客户端，提供工具软件的一键下载、安装、打开和卸载功能。 ISV ISV（Independent Software Vendor），独立软件开发商，是具有区域和行业属性的软件类合作伙伴。此处指云商店商家，是指经过有效申请并经过华为同意，通过云商店向用户销售及提供基于云计算，大数据业务的软件，镜像以及服务的企业。

响应消息 响应参数说明请参见下表： 参数 是否必选 类型 最大字符长度 说明 resultCode M String 6 调用结果码。 具体请参见调用结果码说明。 resultMsg O String 255 调用结果描述。 商家的服务器在处理接口请求时，需要做好幂等性处理。 云商店服务有可能重发请求，针对同一订单号，商家的服务器应当返回成功的响应，不应该再做实例延期处理，返回成功响应即可。 响应消息示例： { "resultCode":"000000", "resultMsg":"success." }

请求方法：GET 参数 是否必选 类型 最大字符长度 说明 activity M String 20 接口请求标识，用于区分接口请求场景。 续费场景取值：refreshInstance authToken M String 50 安全校验令牌。 取值请参见authToken取值说明。 orderId M String 64 云商店订单ID。 说明： 续费操作会产生新的订单，与新购时订单ID不一致，请通过instance Id做资源识别。 instanceId M String 64 实例ID。 productId O String 64 产品标识，租户续费或转正产品实例时，如果订购周期类型发生变化，会传入变化后的产品类型对应的productId。 expireTime M String 20 过期时间。 格式：yyyyMMddHHmmss trialToFormal O String 2 是否是试用转正请求 不传参数：不是 1：是（试用转包周期） 默认不是试用转正。 timeStamp M String 20 请求发起时的时间戳，取UTC时间。 格式：yyyyMMddHHmmssSSS periodType O String 10 周期类型。 说明： 非必传，如需此参数，计费类型需选择包周期chargingMode=1，包周期购买场景请求时传该参数 年："year" 月："month" chargingMode=3，按次数购买场景请求时不传该参数。 periodNumber O integer 2 周期数量。 说明： 非必传，如需此参数，计费类型需选择包周期chargingMode=1，包周期购买场景请求时传该参数。 周期数量：1,2,3… orderAmount O bigdecimal 20 订单金额。 说明： 该金额为用户实际支付金额，供商家对账参考。 金额值大于等于0，最大三位小数。 单位：元 testFlag O Integer 1 是否调测数据。 1：接口调测数据 不传参数：真实买家同步数据 2018年5月12日新增接口参数：productId和trialToFormal。 2018年5月12日之后发布产品或已发布成功的产品新增规格时，请填写此新参数并通过接口调试（productId为空或者填值，trialToFormal“不传参数”或为“1”都要求调试通过）。 2018年5月12日之前已发布成功的产品，如果不涉及免费试用变更，不要求做接口调试。 请求消息示例： https://example.isv.com?activity=refreshInstance& expireTime=20180725000000&instanceId=03pf80c2bae96vc49b80b917bea776d7&orderId=HWS001014ED483AA1E8&timeStamp=20170725025113409&testFlag=1&authToken=09lsS5y+KCtxBu+ON4TXv1SrjH5KVYka9sx2MauHrQU=

响应参数 表2 响应Body参数 参数 参数类型 描述 access_token String 授权服务器返回给第三方应用的访问令牌。 token_type String 访问令牌类型。固定值：Bearer。 expires_in Long 访问令牌的有效期，以秒为单位。 scope refresh_token String String 授权范围。 refresh_token String 刷新令牌，默认生成，有效期30天。 error String 错误类型。 error_description String 错误描述。 refresh_token有效期设置应比access_token长。

请求参数 表1 FormUrlEncoded参数 参数 是否必选 参数类型 描述 client_id 是 String 应用标识，注册应用后，分配的ClientId。 client_secret 是 String 应用密钥，注册应用后，分配的ClientSecret。(解密后的明文) code 是 String 授权码，认证登录后回调获取的授权码。（code值仅可使用一次） grant_type 是 String 授权类型，固定值：authorization_code。 redirect_uri 否 String 回调地址，注册应用时填写的回调地址。 请求示例 POST {domain_name}/api/v1/oauth2/token Content-Type: application/x-www-form-urlencoded code=z2D...& client_id=NzZeWuiJa91dPSRdZQChMazIh13AW...& client_secret=******...& redirect_uri=https://example.com& grant_type=authorization_code

接口说明 管理员被授权管理某企业后，在买家中心登录，对管理的企业执行新建、编辑、删除部门操作时，云商店调用该接口，请求商家同步该企业的组织增量变更；商家接口需要执行增量组织信息同步，保存信息，并返回通知云商店。 商家的服务器在处理接口请求时，需要做好幂等性处理。 对于同一个实例，相同的租户，相同的orgCode，要支持多次请求新增，或者删除，多次新增不应产生新的数据，且需要返回成功，如果是删除，多次删除也需要返回成功，不能因已删除返回失败，删除时不需要校验(新购商品)接口产生的实例是否存在。

请求方法：POST 接口URL：生产地址+固定子路径，其中固定子路径为/produceAPI/singleOrgSync； 接口示例：生产地址为https://example.isv.com，则接口URL为https://example.isv.com/produceAPI/singleOrgSync Headers请参数 参数 必选 参数类型 描述 authToken M String(255) 签名信息，请参考auth Token取值说明。 BODY请求参数 参数 必选 参数类型 描述 instanceId M String(64) 说明： 卖家申请应用凭证的时候传空，买家必传。 tenantId M String(64) 租户ID，与租户的同步信息保持一致 orgCode M String(64) 部门代码 租户自定义，租户内唯一 orgName M Vachar(128) 部门名称 所在层级唯一，允许租户更新名称 parentCode O String(64) 上级部门的orgCode，如果是顶层部门，这个值为空，其他场景不能为空，允许租户更新当前部门归属的上层部门 flag M Integer(2) 0-删除 1-新增，2-修改 testFlag M Integer(2) 0-生产正式数据 1-调测数据 timeStamp M String 默认时区东8区，时间戳,时间格式：20220420114117642 响应参数 参数 必选 参数类型 描述 resultCode M String(6) 响应码,具体请参见调用结果码说明。 resultMsg O String(255) 响应信息 示例： POST https://example.isv.com/produceAPI/singleOrgSync Connection: keep-alive Content-Type: application/json authToken: "stbNYlu**************2Ubt271qDr6WDAVLtLRb” Host: example.isv.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) { "instanceId": "hua********23456", "instanceId": "hua********23456", "tenantId": "68cbc********0d92f36422fa0e", "orgCode": "10000", "orgName": "开发部", "parentCode": "", "flag": 1, "testFlag": 0, "timeStamp": "20220413093539534" , } HTTP/1.1 200 OK Body-Sign: sign_type="HMAC-SHA256", signature= "xxxxxxxxxx" Content-Type: application/json { " resultCode": "000000", " resultMsg": "Success" } HTTP Body签名: Body-Sign: sign_type="HMAC-SHA256", signature= "xxxxxxxxxxxxx" ，详情参考《HTTP Body签名》。

响应参数 属性名 类型 属性说明 error String 返回信息【失败时，会记录失败原因】 error_description String 返回码 data JSONObject / user JSONObject 用户信息 id String 用户id user_name String 用户名 name String 姓名 mobile String 手机号 email String 邮箱 role String 角色 organizationName String 组织名称 accName String 登录名称 userId String 用户id organizationCode String 组织编码 loginName String 登录名称 projectName String 租户名称 tenant String 租户id 响应示例 正确示例 { "user": { "id": "20201119181527383-7B3B-0571E338A", "name": "lx4321", "user_name": "lx4321", "mobile": "139******", "email": "******" } } 错误示例 { "error": "The system is busy. Please try again later.", "error_description": " OneAccess .1009" }

请求参数(post Body) 参数名 类型 描述 是否必须 示例值 sso_ticket String 一次性访问凭证 是 ***** operating_sys_version String 调用方操作系统版本 是 windows10.1.1 device_ip String 调用方设备ip 是 192.168.1.1 device_fingerprint String 调用方设备指纹 是 ***** agent String User-Agent信息 否 agent:Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4389.82 Safari/537.36 请求示例 POST https://bc.bccastle.com/api/v2/tenant/sso/sso-ticket/verify { "sso_ticket":"*****", "operating_sys_version":"windows10.1.1", "device_ip":"192.168.1.1", "device_fingerprint":"*****", "agent":"agent:Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4389.82 Safari/537.36" }

响应参数 属性名 类型 属性说明 error_msg String 返回信息【失败时，会记录失败原因】 error_code String 返回码 expire Number 过期时间 sso_ticket String 返回的sso_ticket 响应示例 正确示例 { "expire":9600 "sso_ticket":"*****" } 错误示例 { "error_msg": "The system is busy. Please try again later.", "error_code": "OneAccess.1009" }

请求参数(post Body) 参数名 类型 描述 是否必须 示例值 session_token String 登录成功返回的token 是 ****** operating_sys_version String 调用方操作系统版本 是 windows10.1.1 device_ip String 调用方设备ip 是 192.168.1.1 device_fingerprint String 调用方设备指纹 是 ****** agent String User-Agent信息 否 agent:Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4389.82 Safari/537.36 请求示例 POST https://bc.bccastle.com/api/v2/tenant/sso/session-token/sso-ticket { "session_token":"******", "operating_sys_version":"windows10.1.1", "device_ip":"192.168.1.1", "device_fingerprint":"******", "agent":"agent:Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4389.82 Safari/537.36" }

响应消息 响应参数说明请参见下表： 参数 是否必选 类型 最大字符长度 说明 error_code M String 6 调用结果码。 具体请参见调用结果码说明。 error_msg O String 255 调用结果描述。 错误码： http状态码 error_code error_msg 描述 200 MKT.0000 Success. 请求成功 500 MKT.0999 System internal error. 其它服务内部错误 500 MKT.0100 Failure of input parameter 输入参数校验失败 参数范围超限，非法值或格式错误 400 MKT.0101 Invalid parameter 参数无效 输入非接口定义的参数，多参数或少必选参数 比如：传递非法数值、没有实例id等 400 MKT.0102 Invalid body sign 请求body体签名校验失败 400 MKT.0199 Request parameter error 请求参数错误 其它参数错误 比如：必填参数未传递等 401 MKT.0150 Illegal operation 通常是进行了不被授权的操作，例如instance_id对应的产品不是AK/SK对应的ISV发布的 401 MKT.0151 No authority 无API访问权限 token非ISV角色 401 MKT.0154 Illegal token 鉴权失败 token无效 500 MKT.9001 Instance ID not found. 实例ID不存在（商品续费、过期、资源释放接口可能返回） 500 MKT.9002 Invalid usage enties. 计量实体无效 500 MKT.9003 Usage records extends size limit. 计量记录数超出限制（1000条） 500 MKT.9004 Record beginTime extends Limit. 计量记录的起始时间超出有效期（当前时间21天以内） 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 响应消息示例： { "error_code":"MKT.0000", "error_msg":"success" }

请求方法：GET 参数 是否必选 类型 最大字符长度 说明 activity M String 20 接口请求标识，用于区分接口请求场景。 过期场景取值：expireInstance authToken M String 50 安全校验令牌。 取值请参见authToken取值说明。 instanceId M String 64 实例ID orderId M String 64 新购商品时对应的订单ID。 timeStamp M String 20 请求发起时的时间戳，取UTC时间。 格式：yyyyMMddHHmmssSSS testFlag O Integer 1 是否调测数据。 1：接口调测数据 不传参数：真实买家同步数据 请求消息示例： https://example.isv.com?activity=expireInstance&instanceId=03pf80c2bae96vc49b80b917bea776d7 &timeStamp=20170725025113409&testFlag=1&authToken=09lsS5y+KCtxBu+ON4TXv1SrjH5KVYka9sx2MauHrQU=

响应消息 响应参数说明请参见下表： 参数 是否必选 类型 最大字符长度 说明 resultCode M String 6 调用结果码。 具体请参见调用结果码说明。 resultMsg O String 255 调用结果描述。 商家的服务器在处理接口请求时，需要做好幂等性处理。 云商店服务有可能重发请求，针对同一instanceId，商家的服务器不应该重复做实例过期处理，返回成功响应即可。 响应消息示例： { "resultCode":"000000", "resultMsg":"success." }