检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
示例二:给指定设备下发消息 场景描述 本章节指导用户通过API给指定设备下发消息。API的调用方法参见如何调用API。 涉及接口 查询设备列表:确定待下发消息的设备。 下发设备消息:给指定设备下发消息。 查询指定消息id的消息:确认消息下发结果。 操作步骤 确定待下发消息的设备。
创建资源空间 功能介绍 资源空间对应的是物联网平台原有的应用,在物联网平台的含义与应用一致,只是变更了名称。应用服务器可以调用此接口创建资源空间。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/apps 表1 路径参数 参数 是否必选
查询设备所有隧道 功能介绍 用户可通过该接口查询某项目下的所有设备隧道,以实现对设备管理。应用服务器可通过此接口向平台查询设备隧道建立的情况。 该API接口在基础版不支持。 具体应用可见“设备远程登录”功能,请参见设备远程登录。 调用方法 请参见如何调用API。 URI GET
设备属性上报通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件(Resource:device.property,Event:report)、创建规则动作、修改规则触发条件接口配置并激活规则后,当设备上报属性数据时,物联网平台会向应用服务器推送通知消息。 URI POST
产品添加通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件(Resource:product,Event:create)、创建规则动作、修改规则触发条件接口配置并激活规则后,当物联网平台中的产品添加时,物联网平台会向应用服务器推送通知消息。 URI POST /由应用服务器创建产品添加通知规则的转发目标决定
查询资源空间 功能介绍 资源空间对应的是物联网平台原有的应用,在物联网平台的含义与应用一致,只是变更了名称。应用服务器可以调用此接口查询指定资源空间详情。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/apps/{app_id} 表1
添加设备组 功能介绍 应用服务器可调用此接口新建设备组,一个华为云账号下最多可有1,000个设备组,包括父设备组和子设备组。设备组的最大层级关系不超过5层,即群组形成的关系树最大深度不超过5。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/device-group
创建设备策略 功能介绍 应用服务器可调用此接口在物联网平台创建一个策略,该策略需要绑定到设备和产品下才能生效。 一个实例最多能创建50个设备策略。 仅标准版实例、企业版实例支持该接口调用,基础版不支持。 调用方法 请参见如何调用API。 URI POST /v5/iot/{pro
创建网桥 功能介绍 应用服务器可调用此接口在物联网平台创建一个网桥,仅在创建后的网桥才可以接入物联网平台。 一个实例最多支持20个网桥。 仅标准版实例、企业版实例支持该接口调用,基础版不支持。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/bridges
态”,不支持快速配置。 设备状态:将归属在某个资源空间下的直连或非直连设备状态变更转发至其他服务。单击“快速配置”,您可以转发设备状态为“在线”、“离线”和“异常”的设备信息到其他服务。物联网平台直连设备状态详见这里。 批量任务:将批量任务状态的数据设置为数据来源。当数据来源选择“批量任务”时,不支持快速配置。
授权项列表 API分组 权限 API 授权项(Action) 产品管理 创建产品 POST /v5/iot/{project_id}/products iotda:products:create 查询产品列表 GET /v5/iot/{project_id}/products i
属性下发 概述 属性下发分为查询设备属性和修改属性参数两种,查询设备属性用于应用侧或平台主动获取设备属性数据,修改属性参数用于应用侧或平台设置设备属性值并同步到设备侧。设备接收到属性下发指令后需要立即响应,如果设备没有响应,平台会认为属性下发执行超时。 使用场景 用于平台主动获取或修改设备属性值。
示例一:使用模板文件批量创建设备 场景描述 本章节指导用户通过API批量创建设备。API的调用方法参见如何调用API。 物联网平台支持通过请求参数和模板文件两种方式批量创建设备。本节以模板文件的方式为例,介绍如何批量创建设备。 涉及接口 查询产品列表:确定待创建设备所属的产品。
设备属性上报 功能介绍 用于设备按产品模型中定义的格式将属性数据上报给平台。属性上报和消息上报的区别,请查看消息通信说明。 低配置且资源受限或者对网络流量有要求的设备,不适合直接构造JSON数据与物联网平台通信时,可将原始二进制数据透传到物联网平台。通过开发编解码插件实现二进制数据到平台定义JSON格式的转换。
示例三:在指定资源空间下创建设备 场景描述 本章节指导用户通过API在指定资源空间下创建设备。API的调用方法参见如何调用API。 物联网平台默认为用户创建了一个资源空间,创建设备时默认将设备归属于默认资源空间,如果用户需要对设备分资源空间管理,可以指定资源空间创建设备。 涉及接口
构造请求 本节介绍REST API请求的组成,并以调用物联网平台的查询产品和创建产品接口说明如何调用API,该API可用于获取用户的指定产品信息。 请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} / {resource-path}
平台设置设备属性 功能介绍 用于平台设置设备属性。设备的产品模型中定义了平台可向设备设置的属性,平台可调用此修改设备属性接口设置指定设备的属性数据。设备收到属性设置请求后,需要将执行结果返回给平台,如果设备没回响应平台会认为属性设置请求执行超时。 低配置且资源受限或者对网络流量有
网关上报子设备属性 接口说明 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报最多50个子设备的属性数据。 URI 请求方法 POST URI /v5/devices/{device_id}/sys/gateway/sub-devices/properties/report
设备消息上报通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件(Resource:device.message,Event:report)、创建规则动作、修改规则触发条件接口配置并激活规则后,当设备上报消息数据时,物联网平台会向应用服务器推送通知消息。 URI POST
创建预调配模板 功能介绍 应用服务器可调用此接口在物联网平台创建一个预调配模板。用户的设备未在平台注册时,可以通过预调配模板在设备首次接入物联网平台时将设备信息自动注册到物联网平台。 该预调配模板至少需要绑定到一个设备CA证书下才能生效。 一个实例最多可有10个预调配模板。 仅标