检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 可选 String Header 实例ID。物理多租下各实例的唯一标识，一般华为云租户无需携带该参
设备Profile文件中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令，设备不在线时命令下发失败。下发命令的具体格式需要应用服务器与设备自定义，物联网平台在接口中直接进行封装，透传。
以业务应用订阅设备数据变化通知为例，订阅和推送的流程如下： 应用服务器通过调用物联网平台的订阅接口订阅设备数据变化通知（携带回调地址和通知类型），物联网平台将业务应用的回调地址和订阅的通知类型存储到订阅列表中以便向业务应用推送设备数据变化消息。 设备上报数据给物联网平台。 物联网平台根据订阅时设置的回调地址，将设备数据主动推送给业务应用。
设备消息确认通知 接口说明 应用服务器在物联网平台订阅了设备消息确认通知后（订阅的通知类型为messageConfirm），当平台向设备下发命令，并收到设备返回的命令确认消息（如命令已送达、已执行等）时，平台会向应用服务器推送通知消息。 仅适用于使用MQTT协议接入的设备，例如集成了AgentLite
设备状态变化结果通知 接口说明 应用服务器在物联网平台订阅设备状态变化通知事件后（资源为device.status，事件为update），当物联网平台中的设备状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法
查询设备激活状态 接口说明 应用服务器通过“注册设备”接口在物联网平台注册设备后，在设备首次接入平台之前，设备的激活状态为false；当设备首次接入平台后，设备的激活状态为true（无论设备接入后是处于在线、离线或异常状态）。应用服务器可调用此接口查询设备在物联网平台的激活状态，确定设备是否已接入平台。
资源空间ID。此参数为非必选参数，存在多资源空间的用户需要使用该接口时，建议携带该参数指定订阅哪个资源空间下的消息通知，否则订阅的消息通知将会归属到默认资源空间下。 channel 必选 String Body 物联网平台推送通知消息时使用的协议通道。使用“http”填充，表示该订阅推送协议通道为http(s)协议。
安全认证。在物联网平台的使用中，可用于物联网平台向应用服务器采用HTTPS协议推送数据时，物联网平台认证应用服务器的合法性。本文以Windows环境为例，介绍通过Openssl工具制作调测证书的方法，生成的证书为PEM编码格式的证书，后缀为.cer。 常见的证书存储格式如下表所示。
gatewayId为设备所关联的直连设备（即网关）的deviceId。 appId String(256) 设备所属的应用ID。 desired JsonObject 要向设备下发的配置信息。 timestamp String(256) 数据配置的UTC时间，时间格式：yyyyM
subject Subject Object 订阅的主题信息，即订阅的资源变化事件。 callbackurl String 订阅的回调地址，用于接收对应资源事件的通知消息。 channel String 物联网平台推送通知消息时使用的协议通道。使用“http”填充，表示该订阅推送协议通道为http(s)协议。
数据在物联网平台的保存时间是多久？ 仅开通设备接入服务：对设备上报的数据不进行解析和存储。 设备管理服务（默认开通设备接入服务）：根据在控制台上创建应用时的配置来定义是否存储历史数据，如果设置为存储，则平台最长存储7天。 父主题： 方案咨询（联通用户专用）
模型中定义的属性数据上报给平台，平台解析后的数据上报给设备管理服务进行相关业务处理。 网关批量属性上报：网关设备将批量设备的数据一次性上报到平台，平台解析后的数据上报给设备管理服务进行相关业务处理。 CoAP协议接入的设备考虑到功耗和带宽的影响，当前只支持设备上报原始的二进制码流
注册设备（验证码方式） 接口说明 在设备接入物联网平台前，应用服务器需要调用此接口在物联网平台注册设备，并设置设备的唯一标识（如IMEI）。在设备接入物联网平台时携带设备唯一标识，完成设备的接入认证。 此注册设备接口适用于使用LWM2M/CoAP协议接入的设备，或者集成了AgentLite
URI-scheme 传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 承载REST服务端点的服务器地址，为“host:port”格式，host为服务器的访问域名或IP，port为服务器的访问端口，您可以参考平台对接信息获取应用的接入地址和端口信息。 例如设备
删除设备 接口说明 已在物联网平台注册的设备，若不再需要接入平台时，应用服务器可调用此接口在物联网平台删除设备，使设备无法再接入平台。后续设备若需要再次接入平台，则需重新注册设备。 URI 请求方法 DELETE URI /iocm/app/dm/v1.4.0/devices/{deviceId}
创建设备命令撤销任务 接口说明 应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（PENDING状态），此时应用服务器可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 URI 请求方法 POST URI /iocm/app/cmd/v1
} ] } 转发设备上报的消息 设备上报给平台的消息，不解析消息体中的数据具体含义，直接透传给华为云其他服务。 表3 消息上报规则转发结构体 参数名称 类型 描述 deviceId String 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 productId
如何获取证书？ 请按照以下途径获取： 设备侧Agent Lite的证书 应用服务器加载的平台证书 应用服务器订阅平台数据时，制作调测证书或购买证书。 父主题： 订阅推送（联通用户专用）
String 规则的状态，默认值：active。 active：激活。 inactive：未激活。 app_id String 资源空间ID。此参数为非必选参数，存在多资源空间的用户需要使用该接口时，建议携带该参数指定创建的规则归属到哪个资源空间下，否则创建的规则将会归属到默认资源空间下。
如何获取证书？ 请按照以下途径获取： 设备侧Agent Lite的证书 应用服务器加载的平台证书 应用服务器订阅平台数据时，制作调测证书或购买证书。 父主题： 应用集成（联通用户专用）
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
