华为云用户手册

接口调用示例 请求导航路径 const utmCode = "51N"; const from: number[] = [0, 0, 0]; const to: number[] = [100, 0, 0];const policy: number = 0; XRClient.requestNavi(utmCode, from, to, policy, this.RequestNaviCallBack);//返回从出发地到目的地的路径 获取SDK版本号 XRClient.getVersion();

接口列表 表1 其他接口列表 接口 描述 参数名 参数类型 参数说明 返回值 requestNavi 请求导航路径。 utmCode string 当前utm区域。 void from number[3] 导航出发点utm坐标。 to number[3] 导航目的地utm坐标。 policy number 路线选择策略。 1：最短距离 2：电梯优先 3：扶梯优先 -2：不坐电梯 -3：不走扶梯 callback Function 回调函数，附带导航路径点信息。 getVersion 获取SDK版本号。 - - - string

总体开发思路 使用WebARSDK开发移动端应用的工作流程如图1所示。 图1 工作流程 准备工作。 下载WebARSDK、收集AK/SK信息、开通关联服务。 创建H5移动端工程。 使用原生或者流行框架（如Vue、React）创建H5移动端工程。 引入WebARSDK文件。 下载、解压WebARSDK包，并将下载WebARSDK包放入工程目录，通过外部引入脚本的方式引入WebARSDK文件。 验证租户身份信息。 通过hwar.setAKSK方法将AK/SK传入SDK，验证租户身份信息。 开启AR会话。 获取图像及传感器数据，初始化SLAM，准备相关环境。 实现AR导航和渲染3D内容。 依靠视觉定位，获取当前设备位置，以及请求导航路径，实现空间位置追踪导航；开发者基于SDK输出的图像数据、相机矩阵、路径信息，实现3D数字内容渲染。 父主题： WebARSDK使用手册

无法进行视觉定位原因排查 如果您无法进行视觉定位，建议您排查以下问题： 检查是否竖屏正向手持设备。 侦听事件“LANDSCAPE_BY_ROLL”检查当前屏幕是否竖屏。 侦听事件“ORIENTATION_NORMAL”检查屏幕正向状态。 验证视觉定位效果时，您需竖屏正向手持设备扫描周边环境。 检查定位区域是否在地图服务范围内。 按“F12”打开DevTools，在“Network”页签中查看“vps”的状态码。如果状态码为“400”，请在“Response”页签中查看“error_msg”内容，如显示“access denied, out of your service zone”，则表示位置不在您的地图服务范围。

接口调用示例 侦听事件 用于侦听事件，并触发侦听函数。 XRClient.addEvent(GlobalBus.VPS_RESULT, this.onVpsResult,this); 定义侦听函数。 onVpsResult(evt) { XRClient.log("onVpsResult status" + evt.data.status); XRClient.log("onVpsResult info" + evt.data.info); if (evt.data.status) { XRClient.log("VPS success"); wx.showToast({ title: 'success', icon: 'success', duration: 2000 }) } else { XRClient.log("VPS failure"); wx.showToast({ title: 'failure', icon: 'none', duration: 2000 }) } }, 移除侦听事件 用于移除事件，移除后侦听函数不再触发。 XRClient.removeEvent(GlobalBus.VPS_RESULT, this.onVpsResult); 派发事件 用于派发事件，配合侦听事件使用，接收到此处派发的事件，并做相应处理。 XRClient.dispatchEvent('user_define', { status: false, info: 'test' } );

SDK内部事件 表2 SDK内部事件列表 事件名称 描述 携带数据 数据类型 数据说明 事件说明 VPS_RESULT Vps定位结果事件。 status boolean 定位是否成功。 Vps定位结果返回时触发该事件。 info string 具体定位结果信息。 VPS_TRACKING Vps跟踪状态事件。 status boolean 状态是否为跟踪中。 Vps跟踪状态变化时触发。 SCENE_INSTANCE scene实例事件。 info object scene实例。 初始化视觉定位模块时，派发scene实例事件。

坐标系转换 SDK提供了UTM坐标与渲染引擎（如Three.js、LayaAir）坐标之间的转换方法。 // UTM坐标转成渲染坐标let vecInit = hwar.utm2Render([utm.x, utm.y, utm.z]);// 渲染坐标转成UTM坐标let renderPosUtm = hwar.render2Utm([render.x, render.y, render.z]);

开发概述 HTSDK是接入KooMap AR地图运行服务的端侧SDK，助力于快速构建真实和虚拟融合世界。HTFoundation是适配HTSDK的示例代码，供用户在Unity3D中开发业务。 HTFoundation示例实现了真实世界构建、世界位姿定位和跟踪、虚实世界呈现。基于HTFoundation示例，用户可构建虚拟世界，包括虚拟对象设计、行为设计实现和业务逻辑开发。 图1 工作原理 父主题： HTSDK使用手册

接口调用示例 初始化日志模块 const logger=new Logger() //创建Logger实例XRClient.initLogger(logger)//初始化日志模块 日志存储 XRClient.setIsSaveLog(true) 设置日志存储为“true”，打印日志的同时会写入日志文件到手机（仅Android支持，iOS暂不支持）。 设置日志存储为“false”，不写入日志文件到手机。 设置日志打印级别 XRClient.setLogOutputLevel(1) 日志级别包括：0（不输出）、1 （error） 、 2 （warn）、 3（log） 设置日志级别为0：不输出日志。 设置日志级别为1：只输出error级别日志。 设置日志级别为2：输出error和warn二个级别日志。 设置日志级别为3：输出error、warn、log三个级别日志。 打印普通级别的日志 XRClient.log("打印内容") 打印警告级别的日志 XRClient.warn("打印内容") 打印错误级别的日志 XRClient.error("打印内容")

接口列表 表1 事件接口列表 接口 描述 参数名 参数类型 参数说明 返回值 addEvent 侦听事件。 evtName string 事件ID。 根据实际情况选择Vps定位结果事件ID、Vps状态事件ID或scene实例事件ID。 void cb Function 侦听到事件后，触发的回调函数。 cbThis any 当前实例。 removeEvent 移除侦听事件。 evtName string 事件ID。 根据实际情况选择Vps定位结果事件ID、Vps状态事件ID或scene实例事件ID。 void cb Function 回调函数。 dispatchEvent 派发事件。 evtName string 事件ID。 根据实际情况选择Vps定位结果事件ID、Vps状态事件ID或scene实例事件ID。 void params { key: value, key2: value2 } 事件携带的信息，键值对形式。

接口列表 表1 视觉定位接口列表 接口 描述 参数名 参数类型 参数说明 返回值 init 初始化视觉定位模块。 config { access: string, secret: string, beforeLocateDelta: number, afterLocateDelta: number, autoRequest: boolean, workerPath: string, url: string } 初始化配置参数。 access：认证用的AK。 secret：认证用的SK。 beforeLocateDelta：首次定位成功前每隔几秒触发一次自动请求。 afterLocateDelta：定位成功后每隔几秒触发一次自动请求。 autoRequest：是否开启Vps自动请求。 workerPath：Vps模块用到的worker文件路径。 url：触发定位请求时使用的 域名 。 void requestVps 触发定位请求。 - - - void updatePerFrame 更新相机位姿。 - - - void getCameraOffset 获取相机偏移量。 - - - number[3] getUTMPosition 获取UTM（UNIVERSAL TRANSVERSE MERCARTOR GRID SYSTEM，通用横墨卡托格网系统）坐标。 - - - number[3] destroyVps 销毁视觉定位实例。 - - - void mockVps 模拟定位。 position Vector3 位置，使用UTM坐标系。 void rotation Vector3 朝向，以弧度制表示的欧拉角。

环境要求 已安装配置NodeJS环境。 已安装代码编辑器，如Visual Studio Code。 已安装Web服务器，如http-server、VSCode插件live-server、Tomcat等。 Windows系统电脑已安装Chrome浏览器或基于Chromium内核的浏览器（例如Edge）；Mac系统电脑已安装Safari浏览器。 移动设备已配置后置摄像头、陀螺仪、加速度传感器、GPS芯片等器件。 移动设备已安装支持WebRTC浏览器，如Chrome、Safari、华为浏览器等。

定位失败，定位结果显示“FewPnPInliers”或“ErrorMeanReprojectionErrTooLarge” 原因一：可能是发起定位时使用的图片纹理特征不够明显。 解决方案：在移动端，对着纹理丰富的区域单击“手动请求Vps”重新发起定位。 原因二：可能是平面识别未初始化完成。 解决方案： 查看camera的position和rotation数值。 如果position数值为0，且rotation值不更新，说明平面识别未初始化完成。 对着平面左右平移提升初始化速度，等待初始化完成。 单击“手动请求Vps”重新发起定位。 原因三：移动端不支持V2平面接口。 解决方案： 查看日志确认当前移动端的arVersion版本，如果不是V2版本，则需更换移动端。 父主题： 常见问题

调用前须知 调用API前，您需提前了解如下内容： WebARSDK封装类名为“hwar”，所有API均直接通过类“hwar”来调用，无需实例化。 下文API中的GPS坐标系为WGS84坐标系。 utmCode指UTM（Universal Transverse Mercator Grid System，通用横墨卡托格网系统）投影带号。 图像流约束为宽:高=480:640，您需根据实际情况自行适配设备屏幕尺寸。 参数类型使用了TypeScript语言的声明规范。 父主题： API列表

续费相关的功能 包年/包月专属加密续费相关的功能如表1所示。 表1 续费相关的功能 功能 说明 手动续费 包年/包月专属加密实例从购买到被自动删除之前，您可以随时在DEW控制台续费，以延长使用时间。 自动续费 开通自动续费后，专属加密实例会在每次到期前自动续费，避免因忘记手动续费而导致资源被自动删除。 在包年/包月专属加密实例生命周期的不同阶段，您可以根据需要选择一种方式进行续费，具体如图 专属加密实例生命周期所示。 图1 专属加密实例生命周期 专属加密实例从购买至到期前，处于正常运行阶段，功能均可用。 到期未续费时，首先会进入宽限期，宽限期到期后仍未续费，资源状态变为“已冻结”。 超过宽限期仍未续费将进入保留期，如果保留期内仍未续费，资源将被自动删除。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 在专属加密实例到期前均可开通自动续费，到期前7日凌晨3:00首次尝试自动续费，如果扣款失败，每天凌晨3:00尝试一次，直至到期或者续费成功。到期前7日自动续费扣款是系统默认配置，您也可以根据需要修改此扣款日。

计费模式概述 数据加密 服务中的专属加密实例支持包年/包月（预付费）计费方式，密钥管理服务、凭据管理服务支持按需计费（后付费）计费方式。 包年/包月：一种预付费模式，即先付费再使用，按照订单的购买周期进行结算。购买周期越长，享受的折扣越大。一般适用于设备需求量长期稳定的成熟业务。 按需计费：一种后付费模式，即先使用再付费，按照云服务实际使用时长计费，秒级计费，按小时结算。按需计费模式允许您根据实际业务需求灵活地调整资源使用，无需提前预置资源，从而降低预置过多或不足的风险。一般适用于电商抢购等设备需求量瞬间大幅波动的场景。 表1 计费模式 计费模式 包年/包月 按需计费 付费方式 预付费。 按照订单的购买周期结算。 后付费。 按照云服务器实际使用时长计费。 计费周期 按订单的购买周期计费。 秒级计费，按小时结算。 适用计费项 专属加密实例 密钥管理服务、凭据管理服务 变更计费模式 不支持变更为按需计费模式。 不支持变更为包年/包月计费模式。 适用场景 适用于可预估资源使用周期的场景，价格比按需计费模式更优惠。对于长期使用者，推荐该方式。 适用于计算资源需求波动的场景，可以随时开通，随时删除。 父主题： 计费模式

到期后影响 图2描述了包年/包月DEW资源各个阶段的状态。购买后，在计费周期内资源正常运行，此阶段为有效期；资源到期而未续费时，将陆续进入宽限期和保留期。 图2 包年/包月DEW资源生命周期 到期预警 包年/包月DEW资源在到期前第7天内，系统将向用户推送到期预警消息。预警消息将通过邮件、短信和站内信的方式通知到华为云账号的创建者。 到期后影响 当您的包年/包月DEW资源到期未续费，首先会进入宽限期，资源状态变为“已过期”。宽限期内您可以正常访专属加密实例 如果您在宽限期内仍未续费包年/包月DEW资源，那么就会进入保留期，资源状态变为“已冻结”，您将无法对处于保留期的包年/包月资源执行任何操作。 保留期到期后，如果包年/包月DEW资源仍未续费，那专属加密实例资源将被释放，数据无法恢复。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 关于续费的详细介绍请参见续费概述。

适用场景 包年/包月计费模式需要用户预先支付一定时长的费用，适用于长期、稳定的业务需求。以下是一些适用于包年/包月计费模式的业务场景： 稳定业务需求：对于长期运行且资源需求相对稳定的业务，包年/包月计费模式能提供较高的成本效益。 长期项目：对于周期较长的项目，包年/包月计费模式可以确保在整个项目周期内资源的稳定使用。 业务高峰预测：如果能预测到业务高峰期，可提前购买包年/包月资源以应对高峰期的需求，避免资源紧张。 数据安全要求高：对于对数据安全性要求较高的业务，包年/包月计费模式可确保资源的持续使用，降低因资源欠费而导致的数据安全风险。

计费示例 假设您在2023/06/15 14:30:09购买了一套专属加密实例（版本：标准版，规格：专属加密实例2个）。购买时长为一个月，并在到期前手动续费1个月，则： 第一个计费周期为：2023/06/15 14:30:09 ~ 2023/07/15 23:59:59 第二个计费周期为：2023/07/15 23:59:59 ~ 2023/08/15 23:59:59 您需要为每个计费周期预先付费，计费公式如表2所示。 表2 计费公式 资源类型 计费公式 资源单价 专属加密实例-标准版 实例规格单价 * 台数 * 购买时长 请参见数据加密服务价格详情。 专属加密实例-铂金版（国内） 初装费用 * 台数+实例规格单价 * 台数 * 购买时长 请参见数据加密服务价格详情。 图 包年/包月专属加密实例费用计算示例给出了上述示例配置的费用计算过程。 图中价格仅供参考，实际计算请以数据加密服务价格详情中的价格为准。 图1 包年/包月专属加密实例费用计算示例 在购买专属加密实例时，默认至少购买两个及以上的专属加密实例，保障业务高可靠。单实例购买仅用于测试，如有需要请单独联系销售代表。

通过企业项目进行成本管理 开通企业项目。 只有实名认证为企业的客户才可以开通企业项目，详细步骤请参见如何开通企业项目。 创建企业项目。 您可以根据部门或者业务，创建对应的企业项目，详细步骤请参见创建企业项目。 购买数据加密服务时选择企业项目。 在购买数据加密服务页面，您可以选择已启用的企业项目，新购数据加密服务将按此企业项目进行成本分配。 图1 选择企业项目 通过企业项目维度查看成本分析。 通过企业项目查看成本数据时，建议基于摊销成本进行数据汇总，详细步骤请参见通过企业项目维度查看成本分配。

通过标签进行成本管理 创建预定义标签。 客户在“标签管理服务”控制台中创建预定义标签，详细操作请参见创建预定义标签。 激活成本标签。 激活标签的具体操作请参见激活成本标签。激活成本标签后，才能在“成本分析”、“预算管理”等页面展现。 成本标签不会应用于激活标签之前产生的成本。激活前已产生的成本数据，如果仍需要基于标签分析，可以导出账单明细，基于账单明细中的资源标签字段进行处理分析。 为DEW资源添加标签。 在购买数据加密服务页面，可以选择已经创建的预定义标签。 图2 添加标签 通过成本标签查看成本数据。 通过成本标签查看成本数据时，建议基于摊销成本进行数据汇总，详细操作请参见通过成本标签查看成本数据。

成本优化 成本控制 企业可以在成本中心的“预算管理”页面创建精细粒度的预算来管理成本和使用量，在实际或预测超过预算阈值时，自动发送通知给指定消息接收人。企业还可以创建预算报告，定期将指定预算进展通知给指定消息接收人。 例如企业使用密钥管理服务成本预算，每月预算金额为10000元，当预测金额高于预算金额的80%时发送预算告警。创建的预算如下： 图3 预算基本信息 图4 设置成本范围 图5 设置提醒 详细介绍请参见使用预测和预算来跟踪成本和使用量。 资源优化 成本中心可以通过监控 云防火墙 的历史消费情况，为客户提供云防火墙资源的空闲识别和优化建议，寻找节约成本的机会。您还可以根据成本分析阶段的分析结果识别成本偏高的资源，通过 云监控服务 监控资源的使用情况，确定成本偏高的原因，然后采取针对性的优化措施。

错误码说明 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 模块 http状态码 错误码 错误码说明 Error Message 描述（处理措施） Cloud Eye通用 500 ces.0007 内部错误 Internal service error. 联系技术支持人员 API 400 ces.0001 请求内容不能为空 The content must be specified. 增加正确的请求内容 400 ces.0003 项目ID为空或不正确 The tenant ID is left blank or incorrect. 添加或使用正确的项目ID 400 ces.0004 未指定API版本号 The API version must be specified. 在请求URL中增加API版本号 400 ces.0005 API版本不正确 The API version is incorrect. 使用正确的API版本号 400 ces.0006 分页地址不正确 The paging address is incorrect. 使用正确的分页信息 403 ces.0009 不允许添加系统指标 Adding SYS metric is not allowed 使用正确权限添加指标数据 403 ces.0010 不允许删除系统指标 Deleting SYS metric is not allowed 使用正确权限删除指标信息 400 ces.0011 请求无效 The request is invalid. 检查请求信息 400 ces.0013 无效的URL参数或参数不存在 The URL parameter is invalid or does not exist. 检查URL参数 400 ces.0014 请求体错误 Some content in message body is not correct. 检查请求Body体参数 401 ces.0015 鉴权失败或未提供有效鉴权信息 Authentication fails or the authentication information is not provided. 检查获取token的用户名或密码（或AK、SK）是否正确 404 ces.0016 请求的资源不存在 The requested resource does not exist. 确认所请求资源是否存在 403 ces.0017 鉴权信息错误或者无相应权限 The authentication information is incorrect or the service invoker does not have sufficient rights. 检查获取token的用户名或密码（或AK、SK）的信息、权限是否正确 数据库 500 ces.0008 数据库错误 Database error. 联系技术支持人员 Zookeeper 500 ces.0021 内部锁错误 Internal locking error. 联系技术支持人员 Blueflood 500 ces.0019 指标处理引擎异常 The metric processing engine is abnormal. 联系技术支持人员 Alarm 400 ces.0002 告警ID不能为空 The alarm ID must be specified. 添加正确的Alarm ID信息 403 ces.0018 Alarm配额不足 The number of alarms exceeds the quota 申请更多的Alarm配额 400 ces.0028 创建告警规则时指标和通知类型不匹配 The metric does not support the alarm action type. 根据参数说明修改指标或通知类型，使二者匹配

请求示例 { "one_click_alarm_id" : "o1234567890123456789012", "dimension_names" : { "metric" : [ "disk", "instance_id" ], "event" : [ "resource_id" ] }, "notification_enabled" : true, "alarm_notifications" : [ { "type" : "notification", "notification_list" : [ "urn:smn:123" ] } ], "ok_notifications" : [ { "type" : "notification", "notification_list" : [ "urn:smn:123" ] } ], "notification_begin_time" : "00:00", "notification_end_time" : "23:59"}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 agent_status Array of AgentStatusInfo objects agent插件状态列表 数组长度：1 - 2000 表5 AgentStatusInfo 参数 参数类型 描述 instance_id String 机器id 正则匹配：^[a-zA-Z0-9-]{1,64}$ uniagent_status String uniagent运行状态,none无，running运行中，silent静默中，unknown故障 枚举值： none running silent unknown extensions Array of ExtensionInfo objects 插件信息列表 数组长度：1 - 10 表6 ExtensionInfo 参数 参数类型 描述 name String 插件名称 最小长度：1 最大长度：64 status String 插件状态, none未安装，running运行中，stopped已停止，fault故障（进程异常），unknown故障（连接异常） 枚举值： none running stopped fault unknown version String 插件版本 最小长度：1 最大长度：32 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 正则匹配：^(ces\.[0-9]{4})$ error_msg String 错误信息 最小长度：1 最大长度：256 状态码： 401 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 正则匹配：^(ces\.[0-9]{4})$ error_msg String 错误信息 最小长度：1 最大长度：256 状态码： 403 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 正则匹配：^(ces\.[0-9]{4})$ error_msg String 错误信息 最小长度：1 最大长度：256 状态码： 500 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 正则匹配：^(ces\.[0-9]{4})$ error_msg String 错误信息 最小长度：1 最大长度：256

响应示例 状态码： 200 插件状态查询返回体 { "agent_status" : [ { "instance_id" : "111111111111", "uniagent_status" : "none", "extensions" : [ { "name" : "telescope", "status" : "none", "version" : "2.5.6" } ] } ]}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 发送的实体的MIME类型。默认使用application/json; charset=UTF-8。 缺省值：application/json; charset=UTF-8 最小长度：1 最大长度：64 X-Auth-Token 是 String 用户Token。用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 最小长度：1 最大长度：16384 表3 请求Body参数 参数 是否必选 参数类型 描述 instance_ids 是 Array of strings 机器实例id列表 数组长度：1 - 2000 uniagent_status 否 String uniagent运行状态，不传查所有状态,none无，running运行中，silent静默中，unknown故障 枚举值： none running silent unknown extension_name 否 String 插件名称，不传查所有插件，目前仅支持telescope 枚举值： telescope extension_status 否 String 插件状态，不传查所有状态, none未安装，running运行中，stopped已停止，fault故障（进程异常），unknown故障（连接异常） 枚举值： none running stopped fault unknown

响应示例 状态码： 200 OK { "invocations" : [ { "invocation_id" : "invocationxxx001", "instance_id" : "instancexxx001", "instance_name" : "xxxx", "instance_type" : "E CS ", "intranet_ips" : [ "10.xxx.xx.1" ], "elastic_ips" : [ "1.xx.xx.1" ], "invocation_type" : "INSTALL", "invocation_status" : "RUNNING", "invocation_target" : "telescope", "current_version" : "2.5.1", "target_version" : "2.6.1", "create_time" : 1678070008306, "update_time" : 1678070008306 } ], "count" : 1}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 invocations Array of InvocationInfo objects 任务列表 数组长度：0 - 100 count Long 任务列表总量 最小值：0 最大值：9999999999999 表5 InvocationInfo 参数 参数类型 描述 invocation_id String 任务id 正则匹配：^([0-9A-Za-z]){1}([0-9A-Za-z]|_|-)*$ instance_id String 主机id 正则匹配：^[a-zA-Z0-9-]{1,64}$ instance_name String 主机名称 最小长度：1 最大长度：128 instance_type String 主机类型，ECS弹性云服务器，BMS裸金属服务器 枚举值： ECS BMS intranet_ips Array of strings 内网ip列表 数组长度：0 - 10 elastic_ips Array of strings 弹性公网ip列表 数组长度：0 - 10 invocation_type String 任务类型(INSTALL 安装，UPDATE升级，ROLLBACK回滚，RETRY重试) 枚举值： INSTALL UPDATE ROLLBACK RETRY invocation_status String 任务状态，PENDING 待执行，RUNNING 运行中，TIMEOUT 超时，FAILED 失败，SUCCEEDED 成功，CANCELED 取消，ROLLBACKED已回退 枚举值： PENDING RUNNING TIMEOUT FAILED SUCCEEDED CANCELED ROLLBACKED invocation_target String 任务对象，目前仅支持telescope 枚举值： telescope create_time Long 任务创建时间 最小值：1111111111111 最大值：9999999999999 update_time Long 任务更新时间 最小值：1111111111111 最大值：9999999999999 current_version String 当前版本 最小长度：1 最大长度：64 target_version String 目标版本 最小长度：1 最大长度：64 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 正则匹配：^(taskmgr\.[0-9]{4})$ error_msg String 错误信息 最小长度：1 最大长度：256 状态码： 401 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 正则匹配：^(taskmgr\.[0-9]{4})$ error_msg String 错误信息 最小长度：1 最大长度：256 状态码： 403 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 正则匹配：^(taskmgr\.[0-9]{4})$ error_msg String 错误信息 最小长度：1 最大长度：256 状态码： 500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 正则匹配：^(taskmgr\.[0-9]{4})$ error_msg String 错误信息 最小长度：1 最大长度：256

URI GET /v3/{project_id}/agent-invocations 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id 最小长度：1 最大长度：64 正则匹配：^[a-z0-9]+$ 表2 Query参数 参数 是否必选 参数类型 描述 instance_id 否 String 主机id 正则匹配：^[a-zA-Z0-9-]{1,64}$ instance_type 否 String 主机类型，ECS弹性云服务器，BMS裸金属服务器 枚举值： ECS BMS invocation_id 否 String 任务id 正则匹配：^([0-9A-Za-z]){1}([0-9A-Za-z]|_|-)*$ invocation_type 否 String 任务类型, INSTALL安装, UPDATE升级, ROLLBACK回退，RETRY重试 枚举值： INSTALL UPDATE ROLLBACK RETRY invocation_target 否 String 任务对象，目前仅支持telescope 缺省值：telescope 枚举值： telescope offset 否 Long 分页偏移量 最小值：0 最大值：9999999999999 缺省值：0 limit 否 Integer 分页大小 最小值：1 最大值：100 缺省值：100