云服务器内容精选

  • 相关操作 禁用策略:下发成功的策略可以在“操作”列单击“禁用”,禁用此条策略,单击“禁用”后此条策略的“状态”显示为“禁用(下发中)”,当策略的“状态”变为“禁用(下发成功)”此条策略被禁用。 删除策略:下发成功的策略可以在“操作”列单击“删除”,删除此条策略,单击“删除”后界面右上角提示该条策略删除成功。 数据库加密后不允许禁用和删除,只能通过下发解密策略进行抵消。 编辑操作:数据库加密策略不允许编辑,只有动态脱敏策略可以编辑。
  • 支持的监控指标 VR云渲游平台采集并展示关键的应用体验指标,各项指标的具体含义如表2所示。您可以根据各项监控指标,实时掌握该设备连接的环境质量,了解用户的应用体验。 表2 VR云渲游平台监控指标支持列表 中文名称 英文名称 指标含义 物理MTP时延(ms) PhysicalLatency(ms) 输入动作(头部转动或控制器操作等)与屏幕更新显示(从刷新的屏幕发出的光线)内容之间的时延,单位为ms 用户感知时延(ms) PerceptionLatency(ms) 物理MTP时延 - 动作预测时间 动作预测时间(ms) PredictionInterval(ms) 一帧动作预测的显示时间 - 获取动作当前的时间 上行动作传输时延(ms) TrackInfoTransLatency(ms) 客户端传输动作信息到服务器接收到所消耗的时延 游戏渲染时延(ms) GameRenderLatency (ms) 游戏应用完成一帧画面渲染所消耗的时延 编码前准备资源时延(ms) PrepareResourceLatency (ms) 编码前为一帧画面完成准备资源所消耗的时延 编码时延(ms) EncodeLatency (ms) 完成一帧画面编码所消耗的时延所消耗 FEC编码时延(ms) FecEncodeLatency (ms) 对一帧画面完成FEC编码所消耗的时延 下行帧传输时延(ms) FrameTransLatency(ms) 一帧画面从服务器传输到客户端所消耗的时延 解码时延(ms) DecodeLatency (ms) 客户端解码所消耗的时延 客户端渲染时延(ms) ClientRenderLatency(ms) 客户端完成一帧画面的渲染时延 黑边度数(度数) ErrorInDegree(Degree) 横向视场角(FOV)上的黑边角度(Yaw) 每秒丢包数 PacketsLostInSecond (Packets/s) 画面内容从服务器传输到客户端过程中的丢包率 网络RTT(ms) NetworkRTT (ms) 客户端到服务器之间的网络端到端时延 服务器接收速率(kbps) RecvRate (Mbps) 服务器接收速率(kbps) 服务器发送速率(kbps) SentRate (Mbps) 服务器发送速率(kbps) 客户端接收速率(kbps) ClientRecvRate (Mbps) 客户端接收速率(kbps) 客户端发送速率(kbps) ClientSentRate (Mbps) 客户端发送速率(kbps) 编码算法 TargetCodec 编码算法,表示是264还是265 分辨率 TargetResolution(px * px) 目标分辨率 编码器参数 TargetEncoderConfig 编码器参数 图像帧率 RenderFps 头盔图像帧率
  • 响应示例 状态码: 200 OK [ ] 状态码: 400 Bad Request { "error_code" : "SCB.00000000", "error_msg" : "Parameter is not valid for operation [romalink.link-device.getDeviceShadow]. Parameter is [deviceOid]. Processor is [path].", "request_id" : "cb39e78a-afd3-4e04-901d-70468b1c23dc-1619602712496-cnnorth7a-P-romalink-service01" } 状态码: 404 Not Found { "error_code" : "SCB.00000000", "error_msg" : "Not Found", "request_id" : "624c8be1-39b6-47b7-941d-c159aced368a-1619602544650-cnnorth7a-P-romalink-service01" } 状态码: 500 Internal Server Error { "error_code" : "ROMA.00110002", "error_msg" : "The instance does not exist. project_id: 397cd10b30544c588b2f4a56d83856c4, instance_id: f3bb386a-23ec-47aa-9943-4c60ac658611", "request_id" : "c8c06d0a-be92-4fdf-9d10-bc20131ab158-1619593104919-cnnorth7a-P-romalink-service01" }
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 [数组元素] Array of ShadowService objects OK 表4 ShadowService 参数 参数类型 描述 service_id Integer 服务ID。 最小值:1 最大值:99999999999999999 service_name String 服务名称。 最小长度:2 最大长度:64 properties Array of ShadowValue objects 影子值。 数组长度:1 - 9999 表5 ShadowValue 参数 参数类型 描述 property_name String 属性名称。 最小长度:0 最大长度:64 property_value String 属性最后一次上报值。 最小长度:0 最大长度:64 property_updated_date Long 属性最后一次上报时间,格式timestamp(ms),使用UTC时区。 最小值:1 最大值:99999999999999999 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 系统错误码,针对4xx和5xx类HTTP错误码的详细错误码。 最小长度:0 最大长度:64 error_msg String 错误描述。 最小长度:0 最大长度:200 request_id String 消息ID。 最小长度:0 最大长度:64 状态码: 404 表7 响应Body参数 参数 参数类型 描述 error_code String 系统错误码,针对4xx和5xx类HTTP错误码的详细错误码。 最小长度:0 最大长度:64 error_msg String 错误描述。 最小长度:0 最大长度:200 request_id String 消息ID。 最小长度:0 最大长度:64 状态码: 500 表8 响应Body参数 参数 参数类型 描述 error_code String 系统错误码,针对4xx和5xx类HTTP错误码的详细错误码。 最小长度:0 最大长度:64 error_msg String 错误描述。 最小长度:0 最大长度:200 request_id String 消息ID。 最小长度:0 最大长度:64
  • 迁移前提 1、已开通IoTDA基础版,并购买了IoTDA企业版/标准版。 2、用户的应用平台访问IoTDA的地址可以修改,应用平台访问IoTDA从基础版地址改成企业版实例的地址。 3、用户的设备访问IoTDA的地址可以修改,设备访问IoTDA从基础版地址改成企业版实例的地址。如果设备访问IoTDA的地址不能修改(例如设备不支持固件升级),可以提交工单说明您的诉求。 设备数据迁移时,如果是指定资源空间和设备迁移,迁移数据仅包括设备连接新实例认证需要的身份信息,包括资源空间、产品、证书、设备基本信息和设备状态;暂不包括基础版中的设备分组、服务端订阅、规则引擎和运行日志配置。
  • 查询、修改、删除设备影子 查询设备影子 方法1:应用服务器调用查询设备影子数据接口。 方法2:登录管理控制台,选择您的实例,单击实例卡片进入。在左侧导航栏选择“设备”,单击具体的设备进入到设备的详情页面,在“设备影子”页签中,可以查看当前设备属性数据,包括“上报值”和“期望值”。 如果当前界面中看到“上报值”与“期望值”不一致,原因可能是设备未在线,暂时存储在设备影子中,待同步给设备,期望值会存在深色底纹。 如果当前界面看到的“上报值”与“期望值”一致,则表示设备最近一次上报的属性值与用户期望下发的属性值一致,期望值为白色底纹。 图1 设备影子-查看 修改设备影子 方法1:应用服务器调用配置设备影子预期数据接口。 方法2:登录管理控制台,选择您的实例,单击实例卡片进入。在左侧导航栏选择“设备-所有设备”,在设备列表中单击具体的设备进入到设备的详情页面,在“设备影子”页面,单击“属性配置”,在弹出窗口中输入服务属性对应的期望值,单击"确定"完成设备影子的修改。 图2 设备影子-属性配置 删除设备影子 用户删除设备影子,平台将会将设备影子中的所有数据(包含上报值和期望值)清空。 图3 删除设备影子
  • 业务流程 修改设备属性值 修改desired区属性值,如果设备在线,则设备影子直接同步设备属性值到设备,否则等待设备上线或上报数据时,再同步设备属性值到设备。 用户通过控制台或应用服务器修改设备属性值。消息样例如下: PUT https://{Endpoint}/v5/iot/{project_id}/devices/{device_id}/shadow Content-Type: application/json X-Auth-Token: ******** Instance-Id: ******** { "shadow" : [ { "desired" : { "temperature" : "60" }, "service_id" : "WaterMeter", "version" : 1 } ] } 物联网平台 修改desired区属性值。 物联网平台返回响应消息。 物联网平台判断设备上线或上报数据。 物联网平台将设备属性同步到设备。消息样例如下: Topic: $oc/devices/{device_id}/sys/properties/set/request_id={request_id} 数据格式: { "object_device_id": "{object_device_id} ", "services": [ { "service_id": "Temperature", "properties": { "value": 57, "value2": 60 } }, { "service_id": "Battery", "properties": { "level": 80, "level2": 90 } } ] } 设备返回响应消息。设备影子desired区的属性值发送给设备后,需要设备回响应表示已收到请求。消息样例如下: Topic:$oc/devices/{device_id}/sys/properties/set/response/request_id={request_id} 数据格式: { "result_code": 0, "result_desc": "success" } 7.设备上报数据,当设备进行属性上报时,平台会存储设备最新上报的设备属性值。 设备上报属性时,物联网平台修改设备影子reported区属性值为设备上报的设备属性值。消息样例如下: Topic: $oc/devices/{device_id}/sys/properties/report 数据格式: { "services": [ { "service_id": "Temperature", "properties": { "value": 57, "value2": 60 }, "event_time": "20151212T121212Z" }, { "service_id": "Battery", "properties": { "level": 80, "level2": 90 }, "event_time": "20151212T121212Z" } ] } 设备主动删除设备影子的reported区 设备主动删除reported区service下的单个属性 设备上报属性时,将属性设置为null,平台会将该属性从设备影子reported区删除,消息样例如下: Topic: $oc/devices/{device_id}/sys/properties/report { "services": [ { "service_id": "Temperature", "properties": { "value": null, "value2": 60 }, "event_time": "20151212T121212Z" } ] } 设备主动删除影子reported区的service下的全部的属性 设备上报属性时,将service对应的properties设置为{}时,平台会将reported区该service模块下所有属性从设备影子reported区删除,消息样例如下: Topic: $oc/devices/{device_id}/sys/properties/report { "services": [ { "service_id": "Temperature", "properties": {}, "event_time": "20151212T121212Z" } ] } 查询设备属性值 设备影子保存的是设备最新的设备属性值,一旦设备属性值产生变化,设备会将设备属性值同步到设备影子。用户便可以及时获取查询结果,无需关注设备是否在线。 用户通过控制台或应用服务器查询设备属性值。消息样例如下: GET https://{Endpoint}/v5/iot/{project_id}/devices/{device_id}/shadow Content-Type: application/json X-Auth-Token: ******** Instance-Id: ******** 物联网平台返回desired属性值和report属性值,即期望值和上报值。消息样例如下: Status Code: 200 OK Content-Type: application/json { "device_id" : "********", "shadow" : [ { "desired" : { "properties" : { "temperature" : "60" }, "event_time" : "20151212T121212Z" }, "service_id" : "WaterMeter", "reported" : { "properties" : { "temperature" : "60" }, "event_time" : "20151212T121212Z" }, "version" : 1 } ] }
  • 开发前必读 设备管理功能主要是通过操作两个标准页面(编辑设备、设备管理),来实现电梯设备信息的新增、修改、删除、查询及监控等功能的。 设备管理界面的大致构想,如图1所示。界面上默认显示应用中保存的所有电梯设备信息,可以直接新增、修改或者删除电梯记录,也可以查询部分电梯记录。 单击“新增设备”按钮,可以在界面上插入一个空行,输入内容后单击“保存”,即可新插入一条电梯记录。 直接编辑表格中任意内容,单击“保存”,即可修改任意一条电梯记录。 选中记录,单击“删除”,即可删除任意一条电梯记录。 设置查询条件,单击“查询”,可以查询满足条件的电梯记录。 图1 电梯设备信息管理界面 通过开发设备管理功能,带您学习如何在AstroZero中,开发脚本、服务编排、标准界面和高级界面,并在开发过程中,细致解析设备管理的增加、删除和修改,以及设备位置信息监控功能开发过程及原理。 父主题: 设备管理开发
  • 操作场景 添加设备后,设备下的点位默认没有开通视频管理等服务,您可以按需选择并开通服务。提供的服务如下: 接入调阅服务:提供 视频接入 和管理功能,开通后可以查看实况和录像。使用录像存储服务,首先需要配置接入调阅服务。 录像存储服务:提供云端视频存储功能,开通后设置录像计划进行录像存储,关闭服务后会删除所有录像文件。 行业数据流服务:提供云端存储设备智能告警数据功能,开通后可以在云端保存设备智能告警数据,如智能告警图片、智能分析元数据等。关闭服务后会删除所有相关数据。
  • 响应示例 状态码: 200 OK { "device_id": "952352LWXT***", "device_name": "测试设备", "device_state": "ONLINE", "access_protocol": "HOLO", "device_type": "IPC", "device_system_state": "NORMAL", "description": "test", "model": "JVS-N71-HD", "manufacture": "JOVISION", "channel_total": 10, "stream_total": 2, "firmware": "V1.0", "device_ability" : "ptz,talk", "device_cloud_ability": { "alarm_voice": { "support": "true" }}, "create_time": "2020-06-26 20:42:16", "update_time": "2020-06-26 20:42:16", "protocol_version": "2.0.0", "mac": "xxx", "device_ip": "xxx.xxx.xxx.xxx", "device_port": "8090", "device_org_id": "1234567890***", "device_org_name": "测试组织***", "operator_total": "2", "sdk_ability": "***", "sn": "952352LWXT***" }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Access-Token 是 String 用户认证AccessToken:从获取用户北向接口认证AccessToken中获取 表3 Query参数 参数 是否必选 参数类型 描述 ability 否 Array of strings 查询的能力集列表:不传默认查询所有能力集,数组长度范围[0,10]。能力集对应能力参考设备能力集。 need_cloud_ability 否 Boolean 是否需要返回云上管理的能力集:false,不返回云上能力集信息;true,返回云上能力集信息。不填默认false need_specification 否 Boolean 是否需要能力规格:false,不返回能力规格;true,返回能力规格。不填默认false
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 mac String 设备mac地址 device_id String 设备ID,设备唯一标识符,如:2102412969WLMB002258 device_name String 设备名称 device_state String 设备状态 枚举值: OFFLINE 离线 ONLINE 在线 UNREGISTERED 未注册 access_protocol String 接入类型 枚举值: GB28181 国标 HOLO 好望 device_type String 设备类型 枚举值: IPC 通用相机 NVR NVR设备 MEdge IVS1800设备 IPC-BULLET 枪机 IPC-BOX 筒机 IPC-CONCH 半球/海螺 IPDOME 球机 device_system_state String 设备系统冻结 枚举值: NORMAL 正常 UNAVAILABLE_FROZEN 冻结 description String 设备描述 model String 设备型号,如:D2150 manufacture String 生产厂商,如:HUAWEI channel_total Integer 通道总数 stream_total Integer 每个通道码流数量 firmware String 摄像头固件版本号 device_ability String 设备能力集:枚举类型,参考附录设备能力集,多个能力集用逗号分隔 device_cloud_ability Object 云端能力集规格 create_time String 创建时间 update_time String 更新时间,在设备重新上线后或者移动设备分组后会修改时间 protocol_version String 设备与平台接入协议版本,如:2.0.0 device_ip String 设备IP device_port String 设备端口 device_org_id String 设备组织ID sn String SN号,等于device_id——设备ID,设备唯一标识符 device_org_name String 设备所处的设备组织名称 operator_total String 操作员总数 sdk_ability String sdk能力集
  • URI GET /v1/{user_id}/devices/{device_id} 表1 路径参数 参数 是否必选 参数类型 描述 device_id 是 String 设备ID: 好望设备:大小写字母、数字组成,长度范围[8,32],可在设备外壳或者设备web页面上获取 国标设备:由数字组成,长度为20个字符长度,由客户自行设置,其中第11-13位,必须是以下之一132(IPC)、111(DVR)、118(NVR),用来区分设备类型 user_id 是 String 用户ID:由数字组成,长度范围[15,25],获取方式参考获取user ID与下载AK/SK章节
  • 设备孪生(DeviceTwin) 终端设备通常包含两类数据: 一是不会改变的元数据,包括序列号、资产标识符、Mac地址等描述设备信息的数据。这种数据也可以称为终端设备的静态属性或设备属性。 另一类是终端设备的动态数据,包括特定背景下的终端设备专有实时数据,例如灯的开、关状态。这种数据也可以称为终端设备的孪生属性。 设备孪生具有与物理设备相同的特性,便于终端设备与应用之间进行更好地通信。应用发送的命令首先到达设备孪生,设备孪生根据应用设置的Expected State(期望的状态)进行状态更新,此外终端设备实时反馈自身的Actual State(真实的状态),设备孪生同时记录终端设备的Actual State和Expected State 。这种方式也使终端设备在离线状况下再次上线时,终端设备的状态也能得到同步。 图2 DeviceTwin 在IEF中可以创建终端设备,并能将终端设备与边缘节点关联,关联后会在边缘节点上保存被关联设备的属性和孪生信息。边缘节点上的应用程序可在边缘节点获取终端设备属性、设备孪生信息、以及修改终端设备孪生期望值和真实值。同时IEF负责同步云、边的孪生信息,当有冲突时,将以边缘侧的修改为主。 详细的终端设备状态边云协同机制请参见设备孪生工作原理。
  • 边缘节点和子设备均在线,为什么子设备上报的数据在IoTDA平台查看不到? 查看EdgeHub日志(专业版节点日志路径:/var/IoTEdge/log/sys_edge_hub/log/edge-hub-running.log;专业版节点日志路径:/var/IEF/app/log/sys_edge_hub/log/edge-hub-running.log),触发子设备数据上报时,查看日志内容是否有异常信息。 若日志提示“No services”,为该设备上报的数据与设备产品的serviceId对应不上。当前边缘节点不感知产品的更新。若新建一个空白的设备产品,为边缘节点创建子设备,然后修改设备产品新增服务和属性,则此时设备上报数据中的服务属性在边缘节点无感知,即会出现“No services”的异常。 当进行基于IoT边缘实现模拟MQTT设备的快速接入实践,添加边缘设备时,误操作填写了模块ID后,导致数据无法上报,删除边缘设备后重新添加。模块ID的设置代表设备接入点为该模块;空代表设备接入点为设备自身,相当于网关。 父主题: 子设备管理