检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
URI-scheme 传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 承载REST服务端点的服务器地址，为“host:port”格式，host为服务器的访问域名或IP，port为服务器的访问端口，您可以参考平台对接信息获取应用的接入地址和端口信息。 例如设备管理
调用订阅接口时，回调地址如何获取？ 应用服务器如何收到命令状态变化的通知？ 如何获取证书？ 回调地址可以使用域名吗？ 订阅后消息推送失败，例如提示503如何处理？ 应用服务器收到数据，但是平台显示推送失败？ 应用服务器只有内网地址，能否订阅成功？ 调用订阅接口时，提示回调地址不合法？ 物联网平台只支持HTTPS的回调地址吗？
服务能力用于描述设备具备的业务能力。将设备业务能力拆分成若干个服务后，再定义每个服务具备的属性、命令以及命令的参数。 以水表为例，水表具有多种能力，如上报水流、告警、电量、连接等各种数据，并且能够接受服务器下发的各种命令。Profile文件在描述水表的能力时，可以将水表的能力划分五个服务
设备状态变化结果通知 接口说明 应用服务器在物联网平台订阅设备状态变化通知事件后（资源为device.status，事件为update），当物联网平台中的设备状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法
升级任务有重试策略，当群组中有部分设备升级失败后，是如何重试的？ 当整个任务失败后，只重试失败的子任务，已升级成功的设备不会再重试。 软件升级可以配置重试时间和重试次数，固件只能配置重试次数。 父主题： 软/固件升级（联通用户专用）
物联网平台支持创建设备的“影子”。设备影子用于存储设备最新上报的服务属性数据，以及应用服务器对服务属性的配置（服务属性为设备Profile文件中定义的service属性）。若设备处于离线或异常状态时，应用服务器无法通过命令下发的方式向设备下发配置，此时可把要下发的配置设置到设备影子，
修改设备命令 接口说明 应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时应用服务器可调用此接口修改该命令的状态信息。仅能修改还处于PENDING状态的命令，且当前仅支持把命令状态修改为CANCELED状态，即撤销命令的执行。 URI 请求方法
批量查询订阅 接口说明 应用服务器可在物联网平台上创建多个订阅，以订阅不同类型的设备变更通知。应用服务器若需要查看本应用下所有订阅配置，或者查看某种订阅类型下的所有订阅配置，可调用此接口进行查询。 URI 请求方法 GET URI /iocm/app/sub/v1.2.0/subscriptions
gatewayId为设备所关联的直连设备（即网关）的deviceId。 appId String(256) 设备所属的应用ID。 desired JsonObject 要向设备下发的配置信息。 timestamp String(256) 数据配置的UTC时间，时间格式：yyyyM
设备唯一标识码，通常使用MAC地址，Serial No或IMEI作为nodeId。 说明： 若使用IMEI作为nodeId，根据不同厂家的芯片有不同填写要求。 高通芯片设备的唯一标识为urn:imei:xxxx，xxxx为IMEI号 海思芯片设备的唯一标识为IMEI号 其他厂家芯片的设备唯一标识请联系模组厂家确认。
接口说明 应用服务器在物联网平台订阅了绑定设备通知后（订阅的通知类型为bindDevice），当设备接入并绑定物联网平台时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
创建设备命令撤销任务 接口说明 应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（PENDING状态），此时应用服务器可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 URI 请求方法 POST URI /iocm/app/cmd/v1
MQTT CONNECT连接鉴权 接口说明 物联网平台设备侧支持MQTT协议的connect消息接口，接口规范参考MQTT标准规范，鉴权通过后建立设备与平台间的MQTT连接。 物联网平台目前只支持MQTTS接入，设备通过connect消息接口跟平台建立MQTT连接时，需要携带TLS证
IoT设备如何激活？ 在物联网平台中，激活就是将真实设备在平台进行注册后，和平台进行连接或者上报数据。更多请查看设备监控。 开发中心没有未激活状态，设备在线，您可认为设备就已激活。 父主题： 设备集成（联通用户专用）
接口说明 应用服务器在物联网平台订阅了软件升级结果通知后（订阅的通知类型为swUpgradeResultNotify），当设备的软件升级任务执行完成时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
接口说明 应用服务器在物联网平台订阅了固件升级结果通知后（订阅的通知类型为fwUpgradeResultNotify），当设备的固件升级任务执行完成时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
设备发起的请求：/devices/{deviceId} 设备服务发起的请求：/devices/{deviceId}/services/{serviceId} to 必选 String(1-128) body 表示消息接收者的地址，To就是订阅请求中的From，如应用服务器的userId。 status 必选 String(1-32)
接口说明 应用服务器在物联网平台订阅了删除设备通知后（订阅的通知类型为deviceDeleted），当设备在物联网平台中被删除后，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
非联通用户请查看设备接入服务。 如何获取证书？ 如何获取应用ID和应用密钥？如何重置应用密钥？ 应用服务器如何获取设备上报到物联网平台的数据？ 应用服务器调用接口失败怎么处理？ 应用服务器下发命令失败，收到403的错误，提示回调地址冲突？ 应用服务器如何获取设备的IMEI号？ 应用服务器如何下发缓存命令？
订阅的主题信息，即订阅的资源变化事件。 callbackurl String 订阅的回调地址，用于接收对应资源事件的通知消息。 channel String 物联网平台推送通知消息时使用的协议通道。使用“http”填充，表示该订阅推送协议通道为http(s)协议。 表2 Subject 名称 类型
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
